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将 敏捷 软件 开发 导入 开发 现场 的 领军 人 物 ， 
以 顾问 身份 就 Web 应 用 的 开发 及 服务 指导 过 
多 家 企业 和 团队 。 曾 为 多 家 企业 和 团队 导入 
GitHub， 在 建立 一 天 之 内 多 次 部 署 的 开发 体 
制 方面 拥有 丰富 经 验 。 
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e 译 者 序 


“开源 ”一 词 在 我 国 IT 界 已 经 出 现 了 不 少年 头 ， 但 “社会 化 编程 ” 
想必 没有 多 少 人 接触 过 。 于 是 在 阅读 正文 之 前 ， 容 我 越 租 代 让 蔡 作者 问 
一 个 问题 : 各 位 在 狭小 的 空间 里 呆 上 一 段 时 间 之 后 ， 再 出 门 时 是 否 有 一 
种 豁然 开朗 的 感觉 ”相信 很 多 人 的 答案 都 是 肯定 的 。 对 于 对 日 外 包 出 身 
的 我 来 说 ,“ 社 会 化 编程 ”就 给 了 我 这 种 感觉 。 或 许 外 包 行 业 在 IT 界 只 
是 极端 个 例 ， 但 “让 全 世界 码 农 看 自己 的 代码 ”这 种 事 , WAAR 
都 不 敢 想 吧 。 

GitHub 正 是 这 样 一 个 平台 ， 我 们 在 这 里 可 以 与 全 世界 的 开源 开发 者 
交流 代码 或 心得 。 如 果 您 对 某 款 开源 软件 的 源 代 码 感 兴趣 ， 如 果 您 想 为 
中 意 的 软件 出 一 份 力 ， 如 果 您 自己 编写 了 小 程序 却 苦 茜 找 不 到 人 指点 ， 如 
果 您 想 跟 菜 名 已 久 的 IT 界 明星 ( 俗称“ 大神”) 聊 上 几 句 ,那么 GitHub 

GitHub 的 纯 英文 界面 或 许 会 令 您 望而却步 ， 不 过 不 用 担心 ， 本 书生 
承 了 日 系 技术 书刊 一 贯 的 “手把手 教学 ”风格 ,作者 用 亲切 的 语言 ， 简 
明 扼 要 的 介绍 ， 配 以 生动 详实 的 示例 为 我 们 一 步 步 讲解 GitHub 的 使 用 
方法 ， 带 我 们 在 实践 中 学 习 GitHub。 值 得 一 提 的 是 ， 本 书 配 有 一 个 供 各 
位 实践 的 网 站 ， 请 感 兴趣 的 读者 务必 一 试 。 俗 话说 “ 读 万 卷 书 不 如 行 万 
里 路 ”"， 跟 着 作者 一 边 实践 一 边 阅 读本 书 ， 相 信 各 位 会 对 这 人 句 话 有 一 个 
更 深刻 的 体会 。 

有 些 读者 可 能 要 问 了 ， 代 码 是 企业 的 财产 ， 不 能 随便 发 到 网 上 给 别 
AF, JE GitHub 对 工作 又 有 什么 意义 呢 ? 这 一 点 作者 自然 考虑 到 了 。 
GitHub 面向 社会 化 编程 ， 我 们 所 生活 的 是 一 个 大 社会 ， 我 们 工作 的 企业 
同样 是 一 个 小 社会 ， 虽然 不 能 强行 导入 “社会 化 编程 ”， 但 其 管理 模式 
仍然 值得 借鉴 。 所 以 如 果 您 是 企业 的 决策 者 ， 那 么 请 在 本 书后 半 跟 随 作 
者 一 起 探讨 企业 导入 社会 化 编程 的 利弊 ， 说 不 定 能 为 您 所 在 的 企业 带 来 
新 的 利益 。 

《GitHub 实战 入 门 》 是 国内 比较 少见 的 对 GitHub 及 社会 化 编程 进行 
系统 介绍 的 书籍 。 以 往 我 们 对 于 这 方面 知识 ， 只 能 通过 网 络 上 零 零散 散 
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译 者 序 





的 博客 或 技术 文档 进行 片面 了 解 ， 难 以 把 握 其 全 貌 。 各 位 读 完 这 本 书后 
相信 和 能 得 到 不 少 帮助 。 

最 后 ， 对 男 一 位 帮忙 搭建 本 书 相 关 网 站 的 译 者 以 及 图 灵 文 化 的 各 位 
编辑 致 以 衷心 的 感谢 ， 正 是 有 了 各 位 的 共同 努力 ， 本 书 才 得 以 出 版 。 同 
时 感谢 正在 阅读 本 书 的 您 ， 有 了 您 的 支持 ， 本 书 才能 发 挥 其 价值 。 




















支 鹏 浩 
2015 年 4 月 于 北京 
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@ 序言 








当今 世界 有 众多 开发 者 在 使 用 GitHub 进行 开发 。 本 书 则 在 指导 各 
位 读者 在 开发 现场 如 何 使 用 GitHub 进行 高 效 开发 。 因 此 ， 书 中 除 针 对 
GitHub 进行 讲解 外 ， 也 涉及 了 开发 流程 及 相关 辅助 工具 的 解说 。 

您 在 开发 现场 有 没有 遇 到 过 以 下 几 件 事 ? 








e 代码 审查 不 到 位 ， 审 查 效率 低下 

。 只 有 编程 者 本 人 能 看 懂 的 代码 、 可 靠 性 不 高 的 代码 直接 被 部 署 至 
正式 环境 中 

o 因 键 入 错误 、 理 解 错误 而 造成 的 低级 代码 错误 导致 BUG 频繁 出 现 

。 没有 机 会 和 其 他 人 互相 交流 代码 ， 共 享 知识 ， 相 互 学 习 、 指 正 、 
改善 

e 没有 一 个 简单 高 效 、 能 在 一 天 之 内 添加 多 个 功能 的 开发 流程 





















































GitHub 为 我 们 提供 了 解决 这 些 问 题 的 机 会 和 功能 ， 而 本 书 则 凝练 了 
各 种 运用 GitHub 的 诀窍 。 

笔者 曾 为 多 家 企业 引入 GitHub， 改 善 其 开发 流程 。 本 书 总 结 了 这 些 
经 验 ， 相 信和 能 为 改善 您 的 开发 现场 提供 一 些 帮 助 。 














E 


本 书 在 编撰 过 程 中 得 到 了 多 方 的 大 力 支 持 。 特 此 鸣谢 @yamanetoshi、 
增 田 贵 士 (@masutaka )、bakorer、 山 科 佑 贵 、 寺 田 涉 、Tatsuma Murase, 
杉 野 康 弘 、 泽 义 和 排名 不 分 先后 )。 

另外 ， 长 期 以 来 ， 技 术 评 论 社 的 池田 大 树 为 本 书 的 编辑 与 整理 尽心 
尽力 ,在 此 由 囊 地 表示 感谢 。 























20144E2 月 KILE 
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e 本 书 结构 
本 书 由 10 章 及 2 个 附录 构成 。 

















第 1 章 : 欢迎 来 到 GitHub 的 世界 

讲解 GitHub 是 什么 ， 以 及 有 哪些 革新 之 处 。 在 开源 软件 的 世界 中 ， 
GitHub 为 开发 者 带 来 了 革命 性 的 社会 化 编程 概念 。 在 这 里 我 们 将 会 接触 
这 一 概念 ， 并 对 其 带 来 的 优势 与 功能 进行 讲解 。 




















第 2 章 : Git 的 导入 
要 使 用 GitHub ， 离 不 开 Git 这 一 版 本 管理 系统 。 本 章 将 深入 介绍 关 
于 Git 的 知识 ， 加 深 各 位 对 Git 的 理解 ， 同 时 说 明 实 际 操作 的 相关 流程 
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第 3 X: 使 用 GitHub 的 前 期 准备 

使 用 GitHub 需要 开设 账户 〈 免费 )， 因 此 我 们 将 按照 顺序 为 您 讲解 
正式 使 用 前 需要 进行 的 一 系列 设置 。 
另外 ,本章 还 会 讲解 包括 操作 示例 在 内 的 ， 实 际 在 GitHub 上 创建 

仓库 并 发 布 代码 的 相关 流程 。 











第 4 章 : 通过 实际 操作 学 习 Git 

在 实际 操作 中 学 习 使 用 GitHub 时 所 必需 掌握 的 Git 的 基本 知识 和 操 
作 方 法 。 

从 最 基本 操作 到 多 人 开发 时 所 需 的 复杂 操作 ， 读 者 都 可 以 随 着 本 章 
的 讲解 简单 实践 一 番 。 




















第 5 章 : 详细 解说 GitHub 的 功能 

本 章 我 们 将 以 图 配 文 ， 对 GitHub 的 功能 逐一 进行 讲解 ， 同 时 还 会 
详细 解说 其 作为 源 代码 查看 器 的 功能 ， 带 您 领略 方便 快捷 的 UL 

建议 正在 使 用 GitHub 的 开发 者 也 读 一 读本 章 ， 您 或 许 会 发 现 一 些 
将 来 能 用 到 的 小 技巧 。 
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本 书 结构 | vii 





第 6 章 : 尝试 Pull Request 
Pull Request 是 GitHub 的 代表 功能 ， 本 章 我 们 将 
请 务必 参考 本 书 内 容 试 着 进行 一 次 Pull Request; 


您 亲自 动手 体会 。 





adi 
Gr 





第 7 章 : 接收 Pull Request 
站 在 仓库 维护 方 的 角度 ， 教 您 在 接 到 Pull Request 之 后 应 该 如 何 考 
虑 ， 如 何 判断 ， 以 及 该 进行 哪些 操作 。 








第 8 章 : 与 GitHub 相互 协作 的 工具 及 服务 

前 半 部 分 为 您 讲解 通过 CLI 对 GitHub 进行 操作 时 所 需 的 hub 命令 。 
另外 ， 在 持续 集成 环境 方面 ， 将 讲解 可 与 GitHub 结合 使 用 的 Travis CI 
及 Jenkins 的 构建 及 设 定 方法 。 

除 此 之 外 ， 本 章 还 会 介绍 一 些 能 够 与 GitHub 共同 使 用 的 服务 。 





























第 9 章 : 使 用 GitHub 的 开发 流程 

详细 讲解 以 GitHub 为 中 心 进行 开发 的 GitHub Flow, Git Flow 两 个 
F 发 流程 。 从 两 者 共通 的 团队 开发 心得 到 各 自 开发 流程 的 特征 ， 都 可 以 
通过 本 章 的 讲解 实际 动手 体会 。 











一 





第 10 章 : 将 GitHub 应 用 到 企业 

总 结 在 企业 中 采用 GitHub 时 需要 考虑 的 问题 及 一 些 有 用 的 信息 。 安 
全 保障 、 故 障 信息 、 事 前 需要 考虑 的 问题 、GitHub Enterprise 的 讨论 等 ， 
这 些 实际 引入 GitHub 时 需要 考虑 或 者 了 解 的 知识 将 在 本 章 中 进行 讲解 。 











附录 A : 辅助 GitHub 的 GUI 客户 端 
队 中 并 不 是 每 个 人 都 对 CLI 得心应手 。 因 此 ， 我 们 为 读者 总 结 了 
辅助 GitHub 的 GUI 客户 端的 相关 知识 。 








附录 B: 通过 Gist 轻松 实现 代码 共享 
Gist 能 帮助 开发 者 轻松 与 其 他 人 共享 简单 的 代码 示例 或 日 志 ， 我 们 将 
在 这 部 分 对 Gist 进行 讲解 。 利 用 Gist 可 以 轻松 管理 日 常 的 小 代码 片段 。 
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Æ E AA ler: 《WEB+DB PRESS)Vol.69 的 特辑 《详解 GitHub 一 一 使 用 Pull 
Request 打造 高 效率 的 软件 开发 》 "为 基础 ， 进 行 大 篇 幅 扩 





























展 与 修正 后 作为 图 书 出 版 。 























本 书 的 操作 示例 是 在 以 下 环境 中 进行 的 。 





*OS X 10.9.1 
* git 1.8.52 


部 分 Windows 相关 解说 中 使 月 





月 时 的 版 本 为 基准 。 





由 于 环境 和 时 期 不 同 ， 操 作 


本 书 中 出 现 的 示例 仓库 











对 于 您 应 月 











， 现 阶 
但 是 在 本 书 出 版 后 ， 随 着 时 间 推 移 ， 
第 7 章 的 内 容 以 及 关于 示例 仓库 


、 运 


H 























Et 4 
XE 


HT Windows 8. 537^, GitHub 相关 解说 丝 以 2014 年 2 





行 结果 可 能 会 存在 差异 。 





译 者 及 尝试 Pull Request 的 各 位 读者 进行 维护 。 





可 能 会 发 


同 努 
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] 本 书 内 容 所 产生 的 后 果 ， 本 书 


人 民 邮 电 出 版 社 及 译 者 概 不 负责 ， 特 在 此 声明 。 


本 书 中 提 及 的 公司 名 、 
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生 反 应 变 慢 其 
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实际 使 用 的 注册 商标 或 商标 。 在 正文 中 并 
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本 章 将 为 您 讲解 GitHub 是 什么 ， 以 及 为 什么 全 世界 的 开发 者 都 在 
使 用 它 。 同 时 ， 还 会 带 您 一 起 考察 GitHub 为 开源 软件 世界 带 来 了 怎样 














1.1 什么 是 GitHub 


GitHub 是 为 开发 者 提供 Git 仓库 的 托管 服务 。 这 是 一 个 让 开发 者 与 
朋友 、 同 事 、 同 学 及 陌生 人 共享 代码 的 完美 场所 。 














e GitHub 公司 与 octocat 


GitHub 公司 总 部 位 于 美国 旧金山 ， 拥 有 一 只 不 知 是 章鱼 还 是 猫 的 吉 
祥 物 octocat (图 1.1). 图 1.2 中 是 被 改编 成 各 种 造型 的 octocat 们 ”。 


图 1.1 octocat 


















































(D http;//octodex.github.com/ 
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1.4 什么 是 GitHub 


图 1.2 octocats 


github:octodex RSS FAQ Back to Github 








the Front-End Conttocat by & E the Snow Octocat by & the Electrocat by & 








the Aidorucatby fj the Codercat by iiy the Strongbadtocat by id 





@ 并 不 只 是 Git 仓库 的 托管 服务 


GitHub 除 提供 Git 仓库 的 托管 服务 外 ， 还 为 开发 者 或 团队 提供 了 
系列 功能 ， 帮 助 其 高 效率 、 高 品质 地 进行 代码 编写 。 这 些 功能 将 从 下 一 
章 开 始 详细 讲解 。 

GitHub 的 创始 人 之 一 Chris Wanstrath 兽 有 个 愿望 ， 那 就 是 能 有 一 个 
Git 仓库 的 托管 服务 让 自己 与 朋友 轻松 分 享 代码 ， 而 这 便 成 为 了 GitHub 
诞生 的 契机 。 不 过 ， 他 也 曾经 表示 : Git 仓库 的 托管 服务 是 GitHub 项 目 
的 目标 之 一 ， 这 只 是 漫长 路 程 上 的 一 个 点 而 已 “ 



































e GitHub 的 使 用 情况 
截至 2013 年 12 H , GitHub 托管 的 仓库 数 已 超过 1000 万 ”。 全 世界 








(D http:/www.slideshare.net/rubymeetup/inside-github-with-chris-wanstrath 
© https://github.com/features/hosting 


图 灵 社区 会 员 lxghost2 专 享 尊重 版 权 



























































































































































4 | $8813: 欢迎 来 到 GitHub 的 世界 
每 时 每 刻 都 有 开发 者 在 使 用 它 。 
专栏 ，GitHub 与 Git 的 区 别 
在 此 讲解 一 下 GitHub 与 Git^? 的 区 别 。GitHub 与 Git 是 完 
全 不 同 的 两 个 东西 。 本 书 中 ， 自 始 至 终 都 以 GitHub 和 Git 的 方 
式 区 分 描述 。 
在 Git 中 ， 开 发 者 将 源 代码 存 入 名 叫 “Git 仓库 ”的 资料 库 中 
并 加 以 使 用 。 而 GitHub 则 是 在 网 络 上 提供 Git 仓库 的 一 项 服务 。 
也 就 是 说 ，GitHub 上 公开 的 软件 源 代码 全 都 由 Git 进行 管 
理 。 理 解 Git， 是 熟练 运用 GitHub 的 关键 所 在 。Git 的 相关 知识 ， 











我 们 将 在 第 2 章 中 为 您 i 








up 














解 。 











Èa http:/gitscm.com 
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GitHub 的 出 现 已 使 当今 世界 的 软件 开发 现场 发 生 了 翻天 和 覆 地 的 变 















































化 。 在 这 场 可 称 之 为 革命 的 变革 当中 ， 中国 也 毫 不 例外 地 受到 了 影响 。 
本 章 中 ， 我 们 将 简单 介绍 将 GitHub 导入 日 常 开发 后 会 带 来 哪些 变化 ， 
供 尚未 正式 使 用 GitHub 的 开发 者 们 加 以 了 解 。 
e 协作 形式 变化 

此 前 ， 用 于 辅助 多 人 协同 工作 的 软件 层出不穷 ， 然 而 它们 中 的 大 部 
分 又 一 个 个 退出 了 历史 的 舞台 。 在 这 类 软件 中 ， 群 件 ( Groupware ) 和 








CRM ( Customer Relationship Management， 顾 客 关系 管理 ) 等 脱颖而出 ， 


被 全 世界 的 商业 人 士 所 用 。 








am 























图 灵 社 区 会 员 


但 是 ， 在 以 程序 员 为 代表 的 软件 开发 者 之 间 ， 
助 多 人 协同 编程 的 关键 性 软件 。 因 此 软件 开发 者 们 往往 





您 所 在 的 公司 想必 也 导入 了 这 类 软件 。 














直 都 没有 一 个 用 来 
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系统 、BUG 跟踪 系统 、 代 码 审 查 工具 、 邮 件 列表 、IRC 等 众多 工具 组 合 
在 一 起 ， 以 实现 多 人 协作 。 








现 为 其 


S 





开发 者 们 已 对 这 种 软件 开发 协作 模式 司空 见 惯 ， 然 而 GitHub 的 出 
来 了 巨大 变化 。 下 面 ， 我 们 就 来 介绍 GitHub 的 几 项 功能 。 





@…… 在 开发 者 之 间 引 发 化 学 反应 的 Pull Request 

在 GitHub 这 个 聚集 了 世界 各 地 软件 开发 者 的 地 方 ， 有 个 在 过 去 绝 
对 是 无 法 想象 的 事 正在 飞速 地 进行 着 一 一 素 未 谋面 的 开发 者 们 隔 着 半 个 
地 球 的 距离 共同 开发 软件 。 我 们 不 妨 称 之 为 开发 者 之 间 的 化 学 反应 吧 。 
































这 种 事 成 为 可 能 ， 都 要 归功 于 一 个 名 为 Pull Request 的 功能 ( 图 1.3 )。 











图 1.3 Pull Request 的 页 面 
o . Thismpository ~ Search or type a command G Explore Gist Blog Help hirocaster +- X Ẹ 
eueuc E] github-book / fizzbuzz G unwatch = 3 | ke Star |o P Fork |2 
Add output GitHub Eat 5 
T T yuria merged 3 commits into master from 7-case-output-github 11 months ago 
@ 
M" Conversation 大 | © Commits 3. (F) Files Changed 2 10 uuum n| 
á hircaster commented 11 montha ago Labeis um 
: None yet 
。 含 有 数字 7 时 显示 GitHub ^ 
已 经 实现 。 求 审查 。 — lh 
No milestone. 
» i bp 
E] Add output GitHub LL m 
No one assigned 
» yuriaconrmonisd on (765644 Lib/issbuss. 25129 1 months ago ^6 
Notiications 
缩 进 好 像 不 太 对 。 
4 Unsubscribe 
» yurla commented 11 months ago # 回 participants 
gs 





没有 关于 本 次 实现 的 测试 代码 ， 请 添加 一 份 。 





@yuria 感谢 人 e 

关于 规范 方面 有 个 问题 。 

比如 ， 在 本 次 实现 之 前 ， 数 字 75 应 该 显示 为 fizzbuzz。 

但 在 本 次 实现 后 ， 由 于 属于 “含有 数字 7” 的 范畴 ， 就 会 显示 成 
Do 








Pull Request 是 指 开发 者 在 本 地 对 源 代 码 进行 更 改 后 ， 向 GitHub 中 
托管 的 Git 仓库 请 求 合并 的 功能 。 开 发 者 可 以 在 Pull Request 上 通过 评 
论 交 流 ， 例 如 “修正 了 BUG， 可 以 合并 一 下 吗 ?” 以 及 “我 试 着 做 了 这 
样 一 个 新 功能 ， 可 以 合并 一 下 吗 ?” 等 。 通 过 这 个 功能 ， 开 发 者 可 以 轻 
松 更 改 源 代 码 ， 并 公开 更 改 的 细节 ， 然 后 向 仓库 提交 合并 请 求 。 而 且 ， 
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如 果 请 求 的 更 改 与 项 目的 初衷 相 违 ， 也 可 以 选择 拒绝 合并 。 
GitHub 的 Pull Request 不 但 能 轻松 查看 源 代 码 的 前 后 差别 ， 还 可 以 
对 指定 的 一 行 代码 进行 评论 (图 1.4 )。 通 过 这 一 功能 ， 开 发 者 们 可 以 针 
对 有 具体 的 代码 进行 讨论 ， 使 代码 审查 的 工作 变 得 前 所 未 有 地 民意 。 
1.4 ”针对 某 行 代码 进行 评论 的 实际 截图 











2um lib/fizzbuzz.rb (M show inline notes View 


m ee -6,6 +6,8 ea def calculate number 
'fizz' 
elsif number $ 5 == 0 
'buzz' 
elsif number.to_s.include? '7' 


p: Mf yuria added a note 11 months ago ”© 


缩 进 好 像 不 太 对 。 


Add aline note 


'GitHub' 
else 

number 
end 











e-— 对 特定 用 户 进行 评论 


方便 和 快捷 并 不 是 Pull Request 的 专利 。 任 务 管理 和 BUG 报告 可 以 
通过 Issue 进行 交互 。 如 果 想 让 特定 用 户 来 看 ， 只 要 用 “@ 用 户 名 ”的 
格式 书写 , 对 方便 会 接 到 通知 ( Notifications ) ", 查看 Issue ( 图 1.5 )。 由 
于 也 提供 了 Wiki 功能 ， 开 发 者 可 以 轻松 创建 文档 ， 进 行 公 开 、 共 享 。 
Wiki 更 新 的 历史 记录 也 在 Git 中 管理 ， 可 以 让 用 户 轻 松 更 改 。 


15 ” 写 有 “@ 用 户 名 ”的 评论 截图 


hirocaster commented 11 months ago 


@yuria 感谢 您 的 审查 。 






































关于 功能 方面 有 个 问题 。 

比如 ， 在 本 次 实现 之 前 ， 数 字 75 应 该 显示 fizzbuzz。 

但 在 本 次 实现 后 ， 由 于 属于 “含有 数字 7” 的 范畴 ， 会 显示 成 GitHub。 
您 有 没有 想 过 让 它 显 示 成 fizzbuzzGitHub 这 种 复合 形式 呢 ? 






































(D 通知 的 相关 知识 将 在 第 5 章 中 详细 讲解 。 
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e GitHub Flavored Markdown 





在 GitHub 上， 用 户 所 有 用 文字 输入 的 功能 都 可 以 用 GitHub 
Flavored Markdown ( GFM ) 语法 进行 描述 。 这 个 语法 可 以 让 标记 变 得 简 
单 ， 以 此 写 出 的 评论 与 文档 也 会 更 容易 理解 。 只 记 住 一 个 语法 便 能 在 多 
种 交流 中 使 用 ， 何 乐 而 不 为 呢 ”? 它 还 有 一 个 很 特别 的 功能 ， 那 就 是 可 
以 在 评论 中 添加 文字 表情 ， 使 用 户 间 的 交流 更 加 顺利 。 

随 着 GitHub 的 普及 ， 正 在 有 越 来 越 多 的 服务 开始 兼容 Markdown 
语法 。 





























专栏 : 还 可 以 这 样 写 !! 

GitHub 中 可 使 用 的 描述 方法 并 不 止 “@ 用 户 名 ”一 种 。 

输入 “@ 组 织 名 ”可 以 让 属于 该 Organization ( 组 织 ) 的 所 
成 员 收 到 通知 **。 输 入 “@ 组 织 名 /团队 ”可 以 让 该 团队 的 所 
成 员 收 到 通知 。 这 就 是 同时 向 多 人 发 送 通 知 的 方法 。 

输入 “# 编号 "， 会 连接 到 该 仓库 所 对 应 的 Issue 编号 。 输 入 
“用 户 名 / 仓库 名 # 编 号 ” 则 可 以 连接 到 指定 仓库 所 对 应 的 lssue 
编号 。 只 要 按照 这 类 特定 格式 书写 便 会 自动 创建 链接 。 

多 加 利用 上 述 这 些 功 能 ， 可 以 让 交流 更 有 效率 。 




































































































































































































































































Pi 























注 a Organization 的 详细 内 容 将 在 第 10 章 中 进行 讲解 。 


e 能 看 到 更 多 其 他 团队 的 软件 


GitHub 快捷 的 环境 为 开发 者 带 来 的 合作 伙伴 ， 并 不 只 局 限于 自己 团 
队 内 部 。 只 要 将 感 兴趣 的 仓库 添加 至 Watch 中 ， 就 可 以 在 News Feed 查 
看 该 仓库 的 相关 信息 ( 图 1.6 )。 




















© 


第 3 章 和 第 5 章 还 会 有 GFM 的 相关 讲解 。 
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1.6 在 News Feed 中 查看 各 仓库 信息 





o . Search or type a command © Explore Gist Blog Help 


News Feed Pull Requests 


Ty mum closed issue ralls/ralls#13887 
i Az Arel/AR not replacing binds correct? 





Jm commented on issue rails/rails£13887 
F This is correct. Who finally replace the binds are the database adapter when doing the 
que. 


© peus opened issue ralls/ralls#13887 
WW Are/AR not replacing binds correct? 





"a elect(:title) ? 


是 = —— commented on pull request ralls/ralls#13886 
W good point... my tests cases were always returning a | AssociationRelation .|can 
chanae that.. anv test test case in mind that | can create a | Relation ... 








(te)) Better Organizations 
A weve made it easier to manage organizations. 





View 48 new broadcasts 


Repositorles you contribute to 
E] github-book/ghprb ox 
E] github-book/flzzbuzz ox 


— 

Yero 
Find a Repository. 

All Repositories Public Private Sources Forks 


I ghprb 














比如 ， 将 全 公司 共用 代码 库 的 仓库 添加 到 Watch 中 ， 便 能 在 第 一 时 间 











掌握 最 新 版 本 的 新 功能 或 BUG 修正 的 信息 。 
中 去 ， 积 极地 提出 意见 。 如 有 必要 ， 还 可 以 通 




















dd 您 也 可 以 参与 到 讨论 
过 Pull Request 提交 代码 。 


将 隔壁 团队 正在 开发 的 仓库 添加 到 Watch 中 ， 就 可 以 每 天 查看 他 们 
都 在 开发 什么 功能 。 一 旦 发 现 有 用 的 功能 或 者 库 ， 可 以 立刻 运用 到 自己 
的 开发 团队 。 如 果 能 进一步 交流 ， 分 割 出 共用 的 库 ， 从 而 建立 起 新 的 仓 


























库 ， 便 成 了 不 同 开发 者 团队 间 协 作 的 美谈 。 





@ 与 开源 软件 相同 的 开发 模式 




















将 GitHub 运用 到 企业 中 ， 便 会 带 来 与 开源 软件 开发 相同 的 开发 模 











具 ， 就 可 以 直接 加 入 到 开发 行列 。 
反 过 来 说 ， 只 要 在 企业 中 运用 GitHub, 








式 。 已 经 熟悉 开源 软件 开发 的 开发 者 不 必 专 门 去 学 习 企 业 独自 采用 的 工 
d 


即便 是 刚刚 入 职 成 为 程序 员 


的 应 届 毕 业 生 ， 也 可 以 很 快 投身 到 开源 软件 开发 的 世界 中 。 
也 就 是 说 ， 开 源 软 件 世界 的 软件 开发 与 企业 内 的 软件 开发 将 不 再 有 
隔 闵 。 在 某 些 企业 中 ， 这 两 者 的 区 别 恐 怕 就 是 仓库 公开 与 否 的 区 别 了 。 
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1.3 ”社会 化 编程 


GitHub 这 一 服务 ， 为 开源 世界 带 来 了 社会 化 编程 的 概念 。 这 一 概念 
影响 了 全 世界 众多 程序 员 ， 说 其 是 软件 开发 方法 的 一 次 革命 都 不 为 过 。 
在 这 里 ， 我 们 将 详细 解说 社会 化 编程 的 概念 。 

您 听 过 SOCIAL CODING ( 以 下 称 为 社会 化 编程 ) 这 个 词 吗 ? 如 果 
没有 ， 那 么 您 见 过 图 1.7 的 LOGO m? 

这 是 GitHub” 曾经 使 用 过 的 LOGO。 上 面 附带 着 SOCIAL CODING 
这 一 副标题 。2013 4E 4 月 起 ，GitHub 开始 使 用 图 1.8 中 的 LOGO。 






























































图 1.7 ”GitHub 曾经 的 LOGO 


github 


SOCIAL CODING 














图 1.8 GitHub 的 新 LOGO 


GitHub 


GitHub 这 一 服务 创造 了 社会 化 编程 的 概念 。 随 着 GitHub 的 出 现 ， 
软件 开发 者 们 才 真 正 意义 上 拥有 了 源 代码 。 世 界 上 任何 人 都 可 以 比 从 前 
更 加 容易 地 获得 源 代 码 ， 将 其 自由 更 改 并 加 以 公开 。 如 今 ， 世 界 众多 程 
序 员 都 在 通过 GitHub 公开 源 代码 ， 同 时 利用 GitHub 支持 着 自己 日 常 的 
软件 开发 。 

在 GitHub 出 现 之 前 ， 软 件 开发 中 只 有 一 小 部 分 人 拥有 更 改 源 代码 
的 权利 ， 这 个 特权 阶级 掌握 着 开发 的 主导 权 。 开 发 者 在 改写 、 发 布 源 代 












































(D https;//github.com/ 
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码 之 外 ， 往 往 需要 花 更 多 时 间 和 精力 去 说 服 这 个 特权 阶级 。 这 导致 了 许 
多 起 初 效率 很 高 的 流行 软件 越发 保守 化 ， 最 终 被 时 代 所 抛弃 。 

但 是 ，GitHub 的 出 现 为 软件 开发 者 的 世界 带 来 了 真正 意义 上 的 “ 民 
主 "， 让 所 有 人 都 平等 地 拥有 了 更 改 源 代码 的 权利 。 这 在 软件 开发 领域 
是 一 场 巨大 的 革命 。 而 革命 领导 者 GitHub 的 口号 便 是 “社会 化 编程 ”。 

接 下 来 ,我 们 将 深入 理解 引发 这 场 革命 的 社会 化 编程 ， 同 时 为 您 讲 
解 其 原动力 一 一 GitHub 这 一 服务 的 相关 概要 。GitHub 各 个 功能 将 在 第 3 
章 之 后 为 您 详细 介绍 。 












































1.4 为 什么 需要 社会 化 编程 





当今 的 IT 业界 已 经 没有 了 终身 雇佣 制 ， 人 才 流 动 性 日 益 增 大 。 可 
以 说 ， 每 个 月 我 们 都 能 在 一 些 著名 开发 者 的 博客 中 看 到 这 种 现象 : HK 
刚 发 布 “ 辞 职 了 ”的 消息 ， 月 初 就 勾 “ 入 职 了 ”。 

那么 ， 如 果 您 是 程序 员 的 面试 官 ， 两 者 之 间 您 会 选择 哪 一 位 呢 ? 























。 能 查看 到 以 前 所 写 代码 的 程序 员 or 无 法 查看 的 程序 员 

。 精通 最 新 软件 的 程序 员 or 不 精通 的 程序 员 

。 对 语言 或 软件 差异 带 来 的 不 同文 化 有 所 理解 的 程序 员 or 不 理解 的 
程序 员 











为 了 不 成 为 后 一 种 程序 员 ， 理 解 社会 化 编程 和 GitHub 至 关 重 要 。 








e 不 要 闭 目 塞 听 ， 要 接触 不 同 的 文化 


在 工作 中 接触 非 公 开 代 码 的 职业 程序 员 们 ， 更 应 该 接触 世界 上 的 不 
同文 化 ， 拓 展 见闻 。 如 果 只 在 公司 这 一 封闭 的 小 世界 中 敲 代 码 ， 往 往 在 
不 知 不 觉 间 ， 手 中 的 技术 就 变 得 陈腐 不 堪 了 。 

放眼 世界 ， 注 意 那些 日 新 月 异 的 源 代码 、 技 术 、 设 计 以 及 文化 ,会 
对 自己 编写 的 源 代码 及 成 果 带 来 巨大 影响 。 笔 者 自身 也 曾 在 知名 框架 的 
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实现 中 受到 启发 ， 良 好 地 实现 了 公司 内 部 开发 的 软件 。 


e 会 写 代 码 的 程序 员 更 受 青睐 


在 软件 开发 行业 中 ，Web 业界 的 变化 尤其 激烈 ， 能 实际 编写 源 代 码 
的 程序 员 大 受 青 睐 。 








协调 性 、 管 理 能 力 。 但 如 今 ， 能 踏 踏 实 实 编写 出 代码 的 职业 程序 员 反 而 
更 受 欢 迎 。 这 是 由 于 近年 来 随 着 技术 的 不 断 发 展 ， 开 发 一 项 服务 需要 用 
到 多 种 编程 语言 和 技术 ， 以 求 兼容 多 种 硬件 设备 。 在 这 种 背景 下 ， 判 断 
一 个 求职 者 能 否 编写 项 目 所 需 的 源 代 码 ， 最 切实 可 行 的 办 法 就 是 看 他 实 
际 写 出 的 东西 。 

如 今 ，GitHub 的 出 现 已 经 让 所 有 人 平等 拥有 公开 源 代码 的 权利 。 看 
看 Facebook 或 Twitter 能 了 解 一 个 人 的 品 性 ， 而 看 看 GitHub 就 能 了 解 一 
个 程序 员 的 实力 。 

今后 ， 进 行 社 会 化 编程 的 程序 员 会 越 来 越 多 ， 从 而 成 为 一 种 普遍 现 
象 。 在 不 远 的 将 来 ， 应 聘 的 成 功 与 否 将 取决 于 您 曾经 编写 过 的 代码 。 因 
此 ， 面 向 全 世界 的 代码 公开 必 将 越发 重要 。 以 编写 代码 为 生 的 职业 程序 
员 们 ， 更 应 该 进行 社会 化 编程 。 





















































© GitHub 最 大 的 特征 是 “面向 人 ” 
这 里 讲解 一 下 GitHub 与 单纯 的 仓库 托管 服务 的 不 同 之 处 ， 在 笔者 


看 来 这 是 一 个 重点 问题 。 

GitHub 与 以 往 的 仓库 托管 服务 最 大 的 不 同 点 ， 就 在 于 它 以 人 为 
中 心 。 

以 往 的 仓库 托管 服务 都 是 以 项 目 为 中 心 ， 每 个 项 目 就 是 一 个 信息 封 
闭 的 世界 。 虽 然 能 够 知道 一 个 仓库 的 管理 者 是 谁 ， 但 这 个 管理 者 还 在 做 
哪些 事 ， 我 们 就 不 得 而 知 了 。 
GitHub 除 项 目 之 外 ， 还 可 以 把 注意 力 集 中 到 人 身上 。 我 们 不 但 能 阅 
览 一 个 人 公开 的 所 有 源 代码 ， 只 要 查看 其 控制 面板 中 的 News Feed， 还 
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能 知道 他 对 哪些 仓库 感 兴趣 ， 什 么 时 候 做 过 提交 等 。 一 个 人 在 GitHub 
进行 的 开发 是 一 日 了 然 的 "。 

您 可 以 将 注意 力 聚 焦 到 感 兴趣 的 人 身上 。 他 既 可 以 是 您 崇拜 已 久 的 
超级 黑客 ， 也 可 以 是 同 校 同学 或 公司 的 同事 。 

能 同时 关注 人 与 代码 ， 是 GitHub 为 我 们 带 来 的 一 个 新 的 世界 。 

















1.5 GitHub 提供 的 主要 功能 





在 GitHub 上 ， 有 许多 帮助 开发 者 高 效 输出 优质 代码 的 功能 。 这 里 ， 
我 们 就 简单 地 为 您 说 明 这 些 功 能 。 


e Git 仓库 

一 般 情 况 下 ， 我 们 可 以 免费 建立 任意 个 GitHub 提供 的 Git 仓库 。 但 
如 果 需 要 建立 只 对 特定 人 物 或 只 对 自己 公开 的 私有 仓库 ， 则 需要 依照 套 
和 餐 类 型 ”支付 每 月 最 低 7 美元 的 使 用 费 。 





























@ Organization 


通常 来 说 ， 个 人 使 用 时 只 要 使 用 个 人 账户 就 足够 了 ， 但 如 果 是 公 
司 ， 建 议 使 用 Organization 账户 。 它 的 优点 在 于 可 以 统一 管理 账户 和 权 
限 ， 还 能 统一 支付 一 些 费 用 。 

如 果 只 使 用 公开 仓库 ， 是 可 以 免费 创建 Organization 账户 的 。 因 此 ， 
如 果 是 以 交流 群 或 IT 小 团体 的 形式 进行 软件 开发 时 不 妨 试 一 试 。 组 织 
或 企业 使 用 GitHub 时 需 注 意 的 地 方 将 在 第 10 章 进 行 详细 讲解 。 







































































中 ”控制 面板 的 相关 知识 将 在 第 5 章 中 进行 详细 说 明 。 
Q) https;//github.com/plans 
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e Issue 


Issue 功能 ， 是 将 一 个 任务 或 问题 分 配给 一 个 Issue 进行 追踪 和 管理 
的 功能 。 可 以 像 BUG 管理 系统 或 TIDD ( Ticket-driven Development ) 的 
Ticket 一 样 使 用 。 在 GitHub 上 ， 每 当 进 行 我 们 即将 讲解 的 Pull Request, 
都 会 同时 创建 一 个 Issue。 

每 一 个 功能 更 改 或 修正 都 对 应 一 个 Issue， 讨 论 或 修正 都 以 这 个 
Issue 为 中 心 进行 。 只 要 查看 Issue， 就 能 知道 和 这 个 更 改 相 关 的 一 切 信 
息 ， 并 以 此 进行 管理 。 

在 Git 的 提交 信息 中 写 上 Issue 的 ID (例如 “#7”)，GitHub 就 会 自 
动 生成 从 Issue 到 对 应 提交 的 链接 。 男 外 ， 只 要 按照 特定 的 格式 描述 提 
交 信 息 ， 还 可 以 关闭 Issue。 这 是 一 个 非常 方便 的 功能 ， 请 务必 实践 一 
下 。 详 细 内 容 将 在 第 5 章 中 为 您 讲解 。 
































e Wiki 

通过 Wiki 功能 ， 任 何人 都 能 随时 对 一 篇 文章 进行 更 改 并 保存 ， 因 
此 可 以 多 人 共同 完成 一 篇 文章 。 该 功能 常用 在 开发 文档 或 手册 的 编写 
中 。 语 法 方面 ， 可 以 通过 第 5 章 讲解 的 GEM 语法 进行 书写 。 

Wiki 页 也 是 作为 Git 仓库 进行 管理 的 ， 改 版 的 历史 记录 会 被 切实 保 
存 下 来 ， 使 用 者 可 以 放心 改写 。 由 于 其 支持 克隆 至 本 地 进行 编辑 ， 所 以 
程序 员 使 用 时 可 以 不 必 开 启 浏览 器 。 
























































e Pull Request 


开发 者 向 GitHub 的 仓库 推送 更 改 或 功能 添加 后 ， 可 以 通过 Pull 
Request 功能 向 别人 的 仓库 提出 申请 ， 请 求 对 方 合并 。 

Pull Request 送出 后 ， 目 标 仓 库 的 管理 者 等 人 将 能 够 查看 Pull 
Request 的 内 容 及 其 中 包含 的 代码 更 改 。 

同时 ，GitHub 还 提供 了 对 Pull Request 和 源 代码 前 后 差别 进行 讨论 
的 功能 。 通 过 此 功能 ， 可 以 以 行为 单位 对 源 代码 添加 评论 ， 让 程序 员 之 
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间 高 效 地 交流 。 
详细 内 容 及 实际 发 送 Pull Request 的 流程 将 在 第 6 章 中 进行 讲解 。 





专栏 : GitHub 上 受到 瞩目 的 软件 

在 这 里 为 各 位 介绍 几 个 正在 GitHub 上 开发 的 软件 ( 表 a 
( Sz 2013 年 12 H )。 想 必 其 中 很 多 软件 大 家 都 用 过 或 者 听 过 。 
另外 ,在 GitHub 上 可 以 随时 查看 当前 备 受 瞩目 的 软件 半 *。 

























































































注 a https://github.com/trending 


表 a GitHub 上 正在 开发 的 知名 软件 


































































































名 称 解说 GitHub 的 URL 

Ruby on 在 Ruby 中 使 用 的 一 种 代 | https://github.comyrails/rails 

Rails 表 性 的 开源 Web 框架 

Node 最 近 在 JavaScript 界 大 受 | https://github.com/joyent/node 
欢迎 的 平台 。 又 名 Node.js 

jQuery 当今 所 有 领域 都 在 应 用 的 | https;//github.com/jquery/jquery 
JavaScript 库 

Symfony2 | 通过 PHP 编写 的 全 栈 式 | https://github.com/symfony/ 
Web 框架 symfony 

Bootstrap | 可 以 做 出 Twitter 那 种 界 | https://github.com/twitter/ 
面 的 组 件 集 bootstrap 
































1.6 小结 











本 章 就 实现 了 社会 化 编程 的 GitHub 进行 了 讲解 。 各 部 分 的 详细 解 
说 将 在 随后 的 章 中 进行 。 


e 参考 资料 
如 果 要 更 加 深入 理解 社会 化 编程 的 概念 ， 建 议 参 考 松田 明 先生 的 资 
料 CR L1), 撰写 本 章 时 笔者 就 参考 了 这 些 资料 。 
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表 1.1 “参考 资料 








标题 URL 
«H^ Rails http://www.slideshare.net/a matsuda/rails-development- 


that-doesnt-hurt 























面向 对 象 社会 化 编程 脚本 https://speakerdeck.com/a. matsuda/object-oriented- 
语言 Ruby social-coding-scripting-language-ruby 
社会 化 编程 的 世界 https://speakerdeck.com/u/a matsuda/p/social-coding 




















D ZARI HRR A [REALY Rails I [477272 H438898v—»xvi«a— 
TAVZAZUZbiSERuyllV—LÉxma—r4v2Z0WL 译 者 注 
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Git 仓库 管理 功能 是 GitHub 的 核心 。 因 此 ， 使 用 GitHub 之 前 必须 
先 掌握 Git 的 相关 知识 ， 同 时 本 地 的 设备 还 要 安装 Git 的 环境 。 本 章 我 
们 将 为 大 家 讲解 使 用 Git 所 需 的 知识 及 各 种 设置 。 











2.1 诞生 背景 





Git 属于 分 散 型 版 本 管理 系统 ， 是 为 版 本 管理 而 设计 的 软件 。 

Linux 的 创始 人 Linus Torvalds 在 2005 年 开发 了 Git 的 原型 程序 。 
当时 ， 由 于 在 Linux 内 核 开发 中 使 用 的 既 有 版 本 管理 系统 的 开发 方 许可 
证 发 生 了 变更 ,为 了 更 换 新 的 版 本 管理 系统 ，Torvalds 开发 了 Git; 

Linux 内 核 的 更 新 速度 在 全 世界 也 算 首屈一指 。 因 此 ， 势 必需 要 一 
个 功能 强 、 性 能 高 的 版 本 管理 系统 来 提高 开发 速度 。 

在 当时 的 开源 环境 下 ， 虽 然 已 经 有 数 款 版 本 管理 软件 被 开发 出 来 ， 
但 功能 和 性 能 都 差强人意 。 加 之 Git 是 由 Linus Torvalds 亲自 着 手 开发 
的 ， 可 以 说 在 功能 与 性 能 方面 无 可 挑 吻 。 程 序 员 们 愿意 接受 Git, 很 大 
程度 上 取决 于 这 个 背景 。 

笔者 在 从 Subversion" HUH Git 时 ， 也 对 其 强大 的 功能 和 性 能 感到 震 
惊 。Git 功能 多 到 和 夸张， 让 人 觉得 至 今 都 没 能 彻底 掌握 它 。 同 时 ， 它 大 
画 削 减 了 笔者 花 在 版 本 管理 系统 上 的 时 间 ， 现 在 如 果 没 有 Git， 软 件 开 
发 妨 伯 会 是 一 件 非常 痛苦 的 事情 。 

在 发 布 之 初 ，Git 由 于 其 艰深 难 履 ， 只 有 部 分 黑客 愿意 使 用 。 但 随 
着 众多 开发 者 的 共同 努力 ， 现 在 它 已 被 全 世界 的 程序 员 们 所 采用 。 
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22 什么 是 版 本 管理 


版 本 管理 就 是 管理 更 新 的 历史 记录 。 它 为 我 们 提供 了 一 些 在 软件 开 











(D http://subversion.apache.org/ 
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程 中 必 不 可 少 的 功能 ， 例 如 记录 一 
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回 滚 到 特定 阶段 ， 恢 复 误 删除 的 文件 等 。 
在 Git 出 现 以 前 ， 人 们 普遍 采用 Subversion 等 集中 型 版 本 管理 系统 ， 
在 Git 已 经 成 为 了 主流 。 由 于 GitHub 的 普及 ， 想必 世界 上 使 用 Git 
会 越 来 越 多 。 因 此 要 学 习 版 本 管理 的 各 位 ， 建 议 您 选择 Git. 














e 集中 型 与 分 散 型 


刚才 我 们 提 到 版 本 管理 系统 分 为 Subversion 这 类 














类 分 散 型 的 ， 下 面 就 为 各 位 简单 说 明 一 下 二 者 的 不 同 点 。 


服务 
被 称 


是 一 
JUR 
器 故 





款 软件 添加 或 更 改 源 代码 的 过 














集中 型 的 与 Git 这 





以 Subversion 为 代表 的 集中 型 ， 会 如 图 2.1 所 示 将 仓库 集中 存放 在 
髓 之 中 ， 所 以 只 存在 一 个 仓库 。 这 就 是 为 什么 这 种 版 本 管理 系统 会 


作 集中 型 。 











集中 型 将 所 有 数据 集中 存放 在 服务 器 当中 ， 有 便于 管理 的 优点 。 但 

















且 开 发 者 所 处 的 环境 不 能 连接 服务 大， 
也 就 几乎 无 法 进行 。 服 务 器 宕 机 时 也 是 同样 的 道理 ， 而 且 万 一 服务 


就 无 法 获取 最 新 





的 源 代码 ， 


障 导 致 数据 消失 ， 愁 怕 开 发 者 就 再 也 见 不 到 最 新 的 源 代 码 了 。 
图 2.1 集中 型 




















发 者 A 


gon, 
| Subversion | 二 一 
checkout 














发 者 B 


commit. 
checkore 











仓库 





自己 的 账户 下 。Fork 出 的 仓库 与 原 仓库 是 





图 2.2 是 以 Git 为 代表 的 分 散 型 的 示意 图 。 如 图 中 所 示 ，GitHub 将 





Fork 给 了 每 一 个 用 户 。Fork 就 是 将 GitHub 的 某 个 特定 仓库 复制 到 
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而 个 不 同 的 仓库 ， 开 发 者 可 以 
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22 分 获 型 





GitHub 


< Fork F. x 
Bi [7 ——7 loi 


Pull Request 
pull pull 
push push 


发 者 A Fas TELE 






































如 图 所 示 ， 分 散 型 拥有 多 个 仓库 ， 相 对 而 言 稍 显 复杂 。 不 过 ， 由 于 
本 地 的 开发 环境 中 就 有 仓库 ， 所 以 开发 者 不 必 连 接 远 程 仓库 就 可 以 进行 
开发 。 

图 中 只 显示 了 一 般 的 使 用 流程 。 实 际 上 ， 所 有 仓库 之 间 都 可 以 进行 
push 和 pull。 即 便 不 通过 GitHub， 开 发 者 A 也 可 以 直接 向 开发 者 B 的 
仓库 进行 push 或 pull。 因 此 在 使 用 前 如 果 不 事先 制定 规范 ， 初 学 者 往 
往 会 搞 不 清 最 新 的 源 代 人 码 保 存在 哪里 ， 导 致 开发 失去 控制 。 不 过 不 用 
担心 ， 只 要 各 位 随 着 本 书 的 讲解 亲自 动手 尝试 ， 想 掌握 要 领 并 不 是 一 
件 难事 。 



































e 集中 型 与 分 散 型 哪个 更 好 


要 说 集中 型 与 分 散 型 哪个 更 好 ， 其 实 双方 都 各 有 优 缺 点 ， 需 要 看 具 
体 情况 而 定 。 不 过 ， 随 着 Git 与 GitHub 的 普及 , 今后 使 用 分 散 型 的 开发 
者 将 会 占 绝 大 多 数 。 只 要 规则 制定 得 当 ， 分散 型 同样 能 像 集中 型 那样 进 
行 管 理 。 


有 些 人 在 学 习 版 本 管理 的 相关 知识 时 ， 认 为 该 从 相对 简单 的 集中 型 
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入 手 ， 再 循序 渐进 学 习 分 散 型 。 但 笔者 认为 ， 今 后 用 到 集中 型 的 机 会 很 
少 ， 所 以 不 必 特 地 绕 这 个 弯路 。 

同样 ， 建 议 想 给 团队 导入 版 本 管理 系统 的 读者 选择 GitHub 与 Git。 
如 果 软 件 开发 进行 到 一 半 再 从 集中 型 转 为 分 散 型 ， 不 但 需要 支付 高 额 的 
费用 ,还 要 让 开发 者 花费 大 量 的 精力 与 金钱 去 重新 学 习 。 考 虑 到 今后 的 
各 种 机 遇 与 挑战 ， 从 一 开始 就 选择 分 散 型 ， 必 定 是 各 位 成 功 路 上 的 关键 
一 步 。 

只 要 脑 中 掌握 了 多 个 仓库 并 存 的 概念 ， 学 习 分 散 型 并 不 是 什么 难 
大。 而 且 对 于 刚刚 接触 这 方面 知识 的 人 来 说 ， 由 于 没有 先 人 为 主 的 干 
扰 ， 应 该 很 容易 接受 这 一 概念 。 












































pun 


























iini 





接 下 来 就 让 我 们 在 本 地 环境 中 实际 安装 Git， 进 行 各 种 设置 。 





e Mac 5 Linux 

最 近 的 Mac 中 都 预 装 了 Git。 而 各 版 本 的 Linux 中 也 都 以 软件 包 
(Package) 的 形式 提供 给 用 户 了 ， 所 以 各 位 可 以 直接 使 用 。 关 于 这 两 个 
环境 特有 的 详细 安装 方法 ， 由 于 篇 幅 关 系 恕 不 歼 述 。 























e Windows 


在 Windows 环境 中 ， 最 简单 快捷 的 方法 是 使 用 msysGit^. T 
按照 Downloads 的 向 导 下 载 安装 包 。 本 书 使 用 的 版 本 是 Git-1.8.4- 
preview20130916.exe。 

安装 包 下 载 完 毕 后 ， 只 要 双击 运行 ， 按 照 向 导 一 步 步 安装 即 可 。 下 
面 我 们 对 安装 时 的 设 定 进行 讲解 。 











(D http://msysgit.github.io/ 
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e 组 件 的 选择 





在 图 2.3 的 页 面 中 选择 需要 的 组 件 。 由 于 所 有 必要 组 件 都 已 默认 你 











选 ， 大 可 直接 进入 下 一 步 。 





e 设置 环境 变量 
在 图 2.4 的 页 面 中 ， 可 以 设置 调用 Git 的 环境 





JEL, 
Hi Pim. 


本 书 的 讲 





解 只 


会 用 到 msysGit 中 附属 的 Git Bash 命令 提示 符 ， 所 以 请 选择 最 上 面 的 





Use Git Bash only， 然 后 进行 下 一 步 。 


图 2.3 ”组 件 的 选择 


Select Components 
Which components should be installed? 





Select the components you want to install; dear the components you do not want to 
install. Click Next when you are ready to continue. 














Additional icons ^ 
~ C In the Quick Launch 
Windows Explorer integration 


























Git Bash Here 





上 Oak contest eno (Registry based) 











i Git GUI Here 

- e Advanced context menu (git-cheetah plugin) 

Associate .git* configuration files with the default text editor 
Associate «sh files to be run with Bash 
































Current selection requires at least 81.7 MB of disk space. 
http: //msysgit.googlecode.com/ 











< Back 























R] 
N 
P 
E 


量 的 设置 


Adjusting your PATH environment 
How would you like to use Git from the command line? 





(€) Use Git Bash only 
This is the most conservative choice if you are concerned about the stability 
of your system. Your PATH will not be modified. 

O Run Git from the Windows Command Prompt 


This option is considered safe and no conflicts with other tools are known. 
Oriy Git wil c added tb your PATH: Use this option if you want to use Git 
from a Cygwin Prompt (make sure to not have Cygwin's Git installed). 


O Run Git and included Unix tools from the Windows Command Prompt 


Both Git and its accompanying Unix tools will be added to your PATH. 
Warning: This will override Windows tools like find.exe and 
sortexe. Select this option only if you understand the implications. 





http: //msysgit.googlecode.com/ 
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e— 换行 符 的 处 理 


在 图 2.5 所 示 的 页 面 中 ， 选 择 换行 符 的 相关 设置 。 
GitHub 中 公开 的 代码 大 部 分 都 是 以 Mac 或 Linux 中 的 LF (Line 
Feed) 换行 。 然 而 ， 由 于 Windows 中 是 以 CRLF ( Carriage Return + 

Line Feed ) 换行 的 ， 所 以 在 非 对 应 的 编辑 器 中 将 不 能 正常 显示 。 
Git 可 以 通过 设置 自动 转换 这 些 换行 符 。 使 用 Windows 环境 的 各 位 ， 
ao “Checkout Windows-style, commit Unix-style line endings” 
o 换行 符 在 签 出 时 会 自动 转换 为 CRLF， 在 提交 时 则 会 自动 转换 为 
































LF» 


2.5 “换行 符 的 转换 


Configuring the line ending conversions 
How should Git treat line endings in text files? 


K 





图 Checkout Windows-style, commit Unix- ESPERE 
twi canet o CRLF when checking out text files. When commi! 
xt files, CRLF will be converted to LF. For idis projects, 
pedet tting on MOMS CECI EE C RET 
O Checkout as-is, commit Unix-style line endings 
Git will not perform any conversion when checking out text files. When 
committing text files, CRLF will be converted to LF. For cross-platform projects, 
this is the recommended setting on Unix ("core.autocrlf" is set to "input"). 
O Checkout as-is, commit as-is 
El not perform any conversions when checking out or 


committing 
xt files. Choosing this option is not recommended for cross-platform 
ees fcore.autoalf is set to "false"). 


http:JImsysgit.googlecode.com] 



































各 位 请 注意 以 上 这 几 点 ， 配 合 当前 使 用 的 环境 进行 安装 。 
e Git Bash 


顺利 安装 好 msysGit 之 后 ，Git Bash 会 作为 一 个 应 用 程序 添加 进 系 
统 ， 接 下 来 请 启动 它 。 双 击 之 后 ， 会 弹出 一 个 名 为 Git Bash 的 命令 提示 


符 ( 网 2.6)， 
行 安 装 ， 那 么 git 命令 就 只 








令 提示 符 中 则 无 法 运行 。 
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它 附属 于 msysGit。 如 果 各 位 是 按照 本 书 中 介绍 的 流程 进 


1 能 在 Git Bash "fH, YE Windows 附属 的 命 
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图 2.6 Git Bash 的 运行 页 面 





从 名 字 中 带 有 Bash 就 不 难 猜 到 ，Git Bash 中 照搬 了 许多 Bash 命令 ， 
习惯 Linux 的 人 用 起 来 会 感觉 比 Windows 命令 提示 符 更 得 心 应 好 
个 机 会 ， 不 妨 也 熟悉 一 下 Windows 的 CLI ( Command Line Interface， 命 
令 行 界面 ) 操作 。 





m 
— 
E 


o 














e 本 书 所 用 的 环境 

本 书 中 的 示范 操作 ， 都 是 在 OS X 10.9.1 上 使 用 Git 1.8.5.2 进行 。 其 
他 大 部 分 环境 也 都 提供 了 1.8.x 或 1.7.x 版 本 的 软件 包 ， 所 以 并 不 强求 未 
尾 的 小 版 本 号 一 致 。 不 过 还 是 建议 各 位 尽量 安装 最 新 版 的 Gito 


























2.4 初始 设置 








下 面 我 们 对 本 地 计算 机 里 安装 的 Git 进行 设置 。 








T 





e 设置 姓名 和 邮箱 地 址 
首先 来 设置 使 用 Git 时 的 姓名 和 邮箱 地 址 。 名 字 请 用 英文 输入 。 


$ git config --global user.name "Firstname Lastname" 























it config --global user.email "your emailGexample.com" 
f gi fig --global il "your : il pl 


这 个 命令 ， 会 在 “~/.gitconfig” 中 以 如 下 形式 输出 设置 文件 。 
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[user] 
name - Firstname Lastname 


email = your emailGexample.com 


想 更 改 这些 信 息 时 ， 可 以 直接 编辑 这 个 设置 文件 。 这 里 设置 的 姓名 
和 邮箱 地 址 会 用 在 Git 的 提交 日 志 中 。 由 于 在 GitHub 上 公开 仓库 时 ， 这 
里 的 姓名 和 邮箱 地 址 也 会 随 着 提交 日 志 一 同 被 公开 ， 所 以 请 不 要 使 用 不 
便 公 开 的 隐私 信息 。 

在 GitHub 上 公开 代码 后 ， 前 来 参考 的 程序 员 可 能 来 自 世 界 任何 地 
方 ， 所 以 请 不 要 使 用 汉字 ， 尽 量 用 英文 进行 描述 。 当 然 ， 如 果 您 不 想 使 
j 真 名 ， 完 全 可 以 使 用 网 络 上 的 昵称 。 






















































































@ 提高 命令 输出 的 可 读 性 


顺便 一 提 ， 将 color.ui 设置 为 auto 可 以 让 命令 的 输出 拥有 更 高 的 可 
iE. 


$ git config --global color.ui auto 























“~/.gitconfig” 中 会 增加 下 面 一 行 。 


[color] 











ui = auto 


这 样 一 来 ， 各 种 命令 的 输出 就 会 变 得 更 容易 分 辩 。 
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本 章 中 ,我 们 从 Git 诞生 的 背景 说 起 ， 讲 了 版 本 管理 系统 中 集中 型 
和 分 散 型 的 相关 知识 。 然 后 还 实际 安装 了 Git， 并 进行 了 初始 设置 。 

如 果 您 是 一 名 开发 者 ， 今 后 使 用 Git 的 情况 必然 越 来 越 多 。 请 务必 
认真 进行 初始 设置 。 
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本 章 将 为 各 位 讲解 使 用 GitHub 前 需要 做 的 一 些 准 备 。 





3.1 使 用 前 的 准备 


e 创建 账户 

首先 让 我 们 来 创建 GitHub 账户 。 请 打开 创建 账户 的 页 面 "。 

我 们 会 看 到 如 图 3.1 所 示 的 页 面 。 在 Username 一 栏 中 用 英文 和 数字 
输入 要 创建 的 ID ， 您 的 公开 页 面 的 URL ( http://github.com/ OO ) 会 用 
到 这 个 ID。 其 他 项 — 面 要 求 输入 。 

3.1 “账户 创建 页 面 


GitHub Signin 






































Join GitHub 


The best way to design, build, and ship software. 


Step 
Set up oa personal account 


Create your personal account 

You'll love GitHub 
Username 

Unlimited collaborators 
This wil be your username — you can enter your organization's username next Unlimited pubiic repositories 


Email Address 


We promise we won't share your email with anyone. 





Password 


Useat least onelowercase letter, one numeral, and seven characters. 


Confirm your password 


Ba clicking on "Creste an account" below, you are agreeing to the Tems of 
ice and the Privacy Policy 


填写 完 所 有 项 目 后 点 击 Create an account， 就 能 完成 账户 的 创建 。 
账户 创建 完成 后 会 直接 进入 登录 状态 ， 用 户 可 以 立即 开始 使 用 GitHub。 
登录 状态 下 用 户 名 会 显示 在 页 面 的 右上 方 。 
































(D  https;//github.com/join 
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@ 设置 头像 

在 GitHub 上 随处 可 见 的 头像 (账户 独 有 的 标识 ) 是 通过 Gravatar" 
服务 显示 的 。 使 用 过 WordPress 的 读者 可 能 对 它 有 所 了 解 。 

只 要 使 用 创建 GitHub 账户 时 注册 的 邮箱 在 Gravatar. 上 设置 头像 ， 
GitHub 的 头像 就 会 变 成 您 设置 好 的 样子 。 

头像 并 不 是 使 用 GitHub 时 的 硬性 要 求 ， 但 如 果 为 代码 配 上 编码 者 
的 相貌 或 标识 ， 会 让 人 觉得 安心 ， 同 时 还 可 能 让 对 方 对 您 产生 兴趣 。 毕 
竟 我 们 要 使 用 的 是 能 将 关注 点 聚集 在 人 身上 的 GitHub ， 所 以 建议 各 位 积 
极地 设置 头像 。 









































@ 设置 SSH Key 


GitHub 上 连接 已 有 仓库 时 的 认证 ， 是 通过 使 用 了 SSH 的 公开 密 钥 
认证 方式 进行 的 。 现 在 让 我 们 来 创建 公开 密 钥 认 证 所 需 的 SSH Key, 并 
将 其 添加 至 GitHub。 已 经 创建 过 的 读者 ， 请 用 现 有 的 密 钥 进行 设置 “。 

运行 下 面 的 命令 创建 SSH Key。 


$ ssh-keygen -t rsa -C "your email@example.com" 



































Generating public/private rsa key pair. 
Enter file in which to save the key 











(/Users/your user directory/.ssh/id rsa): EE 





Enter passphrase (empty for no passphrase): 输入 密码 
Enter same passphrase again: 再 次 输入 密码 


“your_email@example.com” 的 部 分 请 改 成 您 在 创建 账户 时 用 的 邮 
箱 地 址 。 密 码 需要 在 认证 时 输入 ， 请 选择 复杂 度 高 并 且 容 易 记 忆 的 组 合 。 
输入 密码 后 会 出 现 以 下 结 


Your identification has been saved in /Users/your user directory/.ssh/id rsa. 

















A 
o 





Your public key has been saved in /Users/your user directory/.ssh/id rsa.pub. 
The key fingerprint is: 
fingerprint your emailGexample.com 


The key's randomart image is: 





(D http://cn.gravatar.com/ 
D 本 部 分 讲解 参照 了 GitHub 的 帮助 说 明 ( https://help.github.com/articles/generating- 
ssh-keys )。 
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ise [r RIA TVO- 


id rsa 文件 是 私有 密 钥 ，id_rsa.pub 是 公开 密 钥 。 


@ 添加 公开 密 外 
在 GitHub 中 添加 公开 密 钥 ， 今 后 就 可 以 用 私有 密 钥 进行 认证 了 。 
点 击 右 上 角 的 账户 设 定 按钮 ( Account Settings )， 选 择 SSH Keys X 
单 。 点 击 Add SSH Key 之 后 ， 会 出 现 如 图 3.2 的 输入 框 。 在 Title 中 输入 
适当 的 密 钥 名 称 。Key 部 分 请 粘贴 id_rsa.pub 文件 里 的 内 容 。id_rsa.pub 
的 内 容 可 以 用 如 下 方法 查看 。 


$ cat -/.ssh/id rsa.pub 
ssh-rsa ”公开 密 钥 的 内 容 your _email@example.com 














3.2 SSH Keys 





Wl hirocaster +- Xx E 


© © | search ortype a command © Explore Gist Blog Help 
hirocaster Need help? Check out our guide to generating SSH keys or troubleshoot common SSH Problems 
Profile SSH Keys Add SSH key 
Account Settings Delete 
mS ns u 
Emails Ā Delete 


Notification Center 
Billing 

Payment History 
SSH Keys 


Security History 








添加 成 功 之 后 ， 创 建 账户 时 所 用 的 邮箱 会 接 到 一 封 提 示 “ 公 共 密 铀 
添加 完成 ”的 邮件 。 

完成 以 上 设置 后 ， 就 可 以 用 手中 的 私人 密 钥 与 GitHub 进行 认证 和 
通信 了 。 让 我 们 来 实际 试 一 试 。 


$ ssh -T git@github.com 
The authenticity of host 'github.com (207.97.227.239)' can't be established. 





























RSA key fingerprint is fingerprint 值 . 
Are you sure you want to continue connecting (yes/no)? 输入 yes 
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出 现 如 下 结果 即 为 成 功 。 
Hi hirocastest! You've successfully authenticated, but GitHub does not 


provide shell access. 
@ 使 用 社区 功能 


既然 说 GitHub 能 够 以 人 为 焦点 ， 那 么 在 创建 账户 后 不 妨 试 试 
Follow (关注 ) 别人 。 在 用 户 信 息 页 面 的 右上 角 点 击 如 图 3.3 所 示 的 按 





钮 即 可 。 
图 3.3 Follow 按钮 





?名 Follow  $- 


这 样 一 来 ， 您 所 Follow 的 用 户 的 活动 就 会 显示 在 您 的 探 人 
中 。 您 可 以 通过 这 种 方法 知道 那个 人 在 GitHub 上 都 做 了 些 什么 。 

对 于 仓库 ， 也 可 以 使 用 Watch 功能 获取 最 新 的 开发 信息 。 如 果 您 经 
常 使 用 的 某 个 软件 正在 GitHub 上 进行 开发 ， 不 妨 去 Watch 一 下 。 


关于 这 部 分 的 内 容 还 将 在 第 5 章 中 详细 讲解 。 























ti rr] 2 T 









































3.2 ”实际 动手 使 用 


e 创建 仓库 
实际 创建 一 个 公开 的 仓库 。 点 击 右 上 角 工 具 栏 里 的 New repository 


(图 3.4) 图 标 ， 创 建新 的 仓库 。 
图 3.4 “新建 仓库 的 按钮 
hirocaster +7 X P 


EÈ New repository 


$3 New organization 
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go 














e Repository name 


参考 图 3.5， 在 Repository name 栏 中 输入 仓库 的 名 称 。 这 里 我 们 输 
A Hello-World。 


3.5 — 新建 仓库 的 页 面 


Owner Repository name 





hirocastest ~ — / | Hello-World Y 


Great repository names are short and memorable. Need inspiration? How about flaming-bear. 


Description (optional) 


© [: | Public 


^" Anyone can see this repository. You choose who can commit. 
© Private 
You choose who can see and commit to this repository. 
@ Initialize this repository with a README 
This will allow you to git clone the repository immediately. 


Add .gitignore: None ~ Add a license: None v 


see 
Create repository 











e Description 








Description 栏 中 可 以 设置 仓库 的 说 明 。 这 一 栏 不 是 必需 项 ， 可 以 留 空 。 
e Public, Private 


在 这 一 栏 可 以 选择 Public 还 是 Private。 这 里 我 们 选择 Public， 创 建 
公开 仓库 ， 仓 库 内 的 所 有 内 容 都 会 被 公开 。 

选择 Private 可 以 创建 非 公 开 仓库 ， 用 户 可 以 设置 访问 权限 ， 但 这 项 
服务 是 收费 的 。 





e Initialize this repository with a README 


TE Initialize this repository with a README 选项 上 打 钩 ， 随 后 
GitHub 会 自动 初始 化 仓库 并 设置 README 文件 ， 让 用 户 可 以 立刻 
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clone 这 个 仓库 。 如 果 想 向 GitHub 添加 手中 已 有 的 Git 仓库 ， 建 议 不 要 
勾 选 ， 直 接手 动 push。 





























e Add .gitignore 


下 方 左 侧 的 下 拉 菜 单 非常 方便 ， 通 过 它 可 以 在 初始 化 时 自动 生 
成 .gitignore 文件” 这 个 设 定 会 帮 我 们 把 不 需要 在 Git 仓 库 中 进行 版 本 管 
理 的 文件 记录 在 .gitignore 文件 中 ， 省 去 了 每 次 根据 框架 进行 设置 的 麻 
烦 。 下 拉 菜 单 中 包含 了 主要 的 语言 及 框架 ,选择 今后 将 要 使 用 的 即 可 。 
4 于 本 书 中 我 们 并 不 使 用 任何 框架 ， 所 以 不 做 选择 。 





















































e Add a license 


右 侧 的 下 拉 菜 单 可 以 选择 要 添加 的 许可 协议 文件 。 如 果 这 个 仓库 中 
包含 的 代码 已 经 确定 了 许可 协议 ， 那 么 请 在 这 里 进行 选择 。 随 后 将 自动 
生成 包含 许可 协议 内 容 的 LICENSE 文件 ， 用 来 表明 该 仓库 内 容 的 许可 
协议 。 

输入 选择 都 完成 后 ， 点 击 Create repository 按钮 ， 完 成 仓库 的 创建 。 

















@ 连接 仓库 
下 面 这 个 URL 便 是 刚刚 创建 的 仓库 的 页 玫 























o 




















https://github .com/ 用 户 名 /Hello-Word 


e README.md 


README.md 在 初始 化 时 已 经 生成 好 了 。README.md 文件 的 内 容 
会 自动 显示 在 仓库 的 首页 当中 。 因 此 ， 人 们 一 般 会 在 这 个 文件 中 标明 本 
仓库 所 包含 的 软件 的 概要 、 使 用 流程 、 许 可 协议 等 信息 。 如 果 使 用 
Markdown 语法 进行 描述 ， 还 可 以 添加 标记 ， 提 高 可 读 性 。 





























QD ”该 文件 用 来 描述 Git 仓库 中 不 需 管 理 的 文件 与 目录 。 
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e GitHub Flavored Markdown 


在 GitHub 上 进行 交流 时 用 到 的 Issue、 评 论 、Wiki， 都 可 以 用 
Markdown 语法 表述 ， 从 而 进行 标记 。 准 确 地 说 应 该 是 GitHub Flavored 
Markdown ( GFM ) 语法 。 该 语法 虽然 是 GitHub 在 Markdown 语法 基础 








上 扩充 而 来 的 ， 但 一 般 情 况 下 只 要 按照 原本 的 Markdown 语法 进行 描述 


就 可 以 。 


关于 Markdown 语法 的 解说 , 网 上 也 有 相关 资料 可 查 "。 各 位 不 妨 一 


边 参考 一 边 实际 党 试 。 
使 用 GitHub 后 ， 很 多 文档 都 需要 




















] Markdown 来 书写 。 也 就 是 说 ， 





全 世界 有 大 量程 序 员 都 在 使 用 Markdown， 因 此 掌握 这 种 语法 已 经 成 为 





程序 员 的 标准 技能 之 一 。 请 各 位 也 务必 学 会 Markdown 语法 。 


e 公开 代码 
@……Clone 已 有 仓库 








接 下 来 我 们 将 尝试 在 已 有 仓库 中 添加 代码 并 加 以 公开 。 首 先 将 已 有 
仓库 clone 到 身边 的 开发 环境 中 。clone 时 指定 的 路 径 请 参考 图 3.6", 





(D http:/www.ituring.com.cn/article/775 
D ”git 命令 请 参考 第 4 章 。 
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图 3.6 CEKK 





@ Unwatch ~ 1 — X Unstar 1 Ẹ Fork 0 


Website 
Website for this repository (optional) Save  orcancel <? Code 
© Issues 0 
0 releases 1 contributor 
I1 Pull Requests 0 
ES Wiki 
latest commit 4fe0227067 [€ *- Pulse 
2 years 
y ago Eh Graphs 
P Network 
3€ Settings 


SSH cione URL 


gitégithub.com:hir| E 


You can clone with HTTPS, SSH, 
or Subversion. © 





lal Clone in Desktop 











$ git clone gitégithub.com:hirocastest/Hello-World.git 
Cloning into 'Hello-World'... 

remote: Counting objects: 3, done. 

remote: Total 3 (delta 0), reused 0 (delta 0) 
Receiving objects: 100% (3/3), done. 


$ cd Hello-World 

这 里 会 要 求 输入 GitHub 上 设置 的 公开 密 钥 的 密码 。 认 证 成 功 后 ， 
仓库 便 会 被 clone 至 仓库 名 后 的 目录 中 。 将 想 要 公开 的 代码 提交 至 这 个 
仓库 再 push 到 GitHub 的 仓库 中 ， 代 人 码 便 会 被 公开 。 














@…… 编写 代码 


这 里 我 们 编写 一 个 hello world.php 文件 ， 用 来 输出 “Hello World!”。 


hello word.php 的 内 容 
<?php 
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echo "Hello World!"; 


82 


由 于 hello. word.php 还 没有 添加 至 Git 仓库 ， 所 以 显示 为 Untracked 
files。 








$ git status 
# On branch master 
# Untracked files: 


# (use "git add <file>..." to include in what will be committed) 
# 
# hello world.php 


nothing added to commit but untracked files present (use "git add" to track) 





将 hello. word.php 提交 至 仓库 。 这 样 一 来 ， 这 个 文件 就 进入 了 版 本 
管理 系统 的 管理 之 下 。 今 后 的 更 改 管理 都 交 由 Git 进行 。 


$ git add hello world.php 
$ git commit -m "Add hello world script by php" 
[master d23b909] Add hello world script by php 
1 file changed, 3 insertions (+) 

create mode 100644 hello world.php 


通过 git add 命 令 将 文件 加 入 暂 存 区 “, 再 通过 git commit 命令 




















添加 成 功 后 ， 可 以 通过 git log 命令 查 看 提交 日 志 。 


$ git log 

commit d23b909caad5d49a281480e6683ce3855087a5da 
Author: hirocastest «hohtsukaGgmail.com» 

Date: Tue May 1 14:36:58 2012 40900 


Add hello world script by php 
略 





中 在 Index 数据 结构 中 记录 文件 提交 之 前 的 状态 。 
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专栏 : 公开 时 的 许可 协议 


即便 在 GitHub 上 公开 了 源 代 码 ， 也 不 代表 著作 者 放弃 了 
著作 权 等 权利 。 代 码 的 权利 持 有 人 请 选择 合适 的 许可 协议 。 在 
GitHub 上 ， 有 修正 BSD 许可 协议 、Apache 许可 协议 等 多 种 许 
















































































可 协议 供 人 们 选择 ， 不 过 大 多 数 软件 都 使 用 MIT 许可 协议 。 





























MIT 许可 协议 具有 以 下 特征 。 






































被 授权 人 权利 : 被 授权 人 有 权利 使 有 用、 复制、 修改 、 合 并 、 出 版 发 行 、 散 布 、 









































再 授权 和 / 或 贩 售 软件 及 软件 的 副本 ， 及 授予 被 供应 人 同等 权利 ， 唯 服 

















声明 。 






































从 以 下 义务 。 


被 授权 人 义务 : 在 软件 和 软件 的 所 有 副本 中 都 必须 包含 以 上 版 权 声 明和 本 许可 


其 他 重要 特性 : 此 许可 协议 并 非 属 copyleft 的 软件 许可 协议 条 款 ， 人 允许 在 







































































及 开放 源 代 码 软件 或 非 自由 软件 ( proprietary software ) 所 使 用 。 















































BSD license, 3-clause BSD license ) 本 质 上 不 同 处 。 




















IT 的 内 容 可 依照 程序 著作 权 者 的 需求 更 改 内 容 。 此 亦 为 MIT 与 BSD (The 






































































































































IT 许 可 协议 可 与 其 他 许可 协议 并 存 。 另 外 ，MIT 条 款 也 是 软件 基金 会 
( FSF ) 所 认可 的 软件 许可 协议 条 款 ， 与 GPL 兼容 。 
一 一 MIT 许可 证 ，Wikipedia，http://zh.wikipedia.org/，2015 年 3 H 27 日 获取 
详细 内 容 请 参阅 原文 三 *。 
实际 使 用 时 ， 只 需 将 LICENSE 文 件 加 入 仓库 并 在 

















README.md 文件 中 声明 使 用 了 何 种 许可 协议 即 可 。 















































使 用 没有 声明 许可 协议 的 软件 时 ， 以 防 万 一 最 好 直 
作者 。 














注 a http://www.opensource.org/licenses/mit-license.php 


e 进行 push 


之 后 只 要 执行 push，GitHub 上 的 仓库 就 会 被 更 新 。 


$ git push 

Counting objects: 4, done. 

Delta compression using up to 4 threads. 

Compressing objects: 100$ (2/2), done. 

Writing objects: 100% (3/3), 328 bytes, done. 

Total 3 (delta 0), reused 0 (delta 0) 

To gitGgithub.com:hirocastest/Hello-World.git 
46ff713..d23b909 master -> master 
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这 样 一 来 代码 就 在 GitHub 上 公开 了 。 不 妨 实际 连接 http://github. 
com/ 用 户 名 /Hello-World 查看 一 下 。Git 更 加 详细 的 操作 请 查阅 第 4 章 。 








3.3 小结 





本 章 讲 解 了 初次 在 GitHub 建立 仓库 以 及 公开 代码 的 流程 。 完 成 这 
些 ， 各 位 就 中 入 了 GitHub 的 世界 。 
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在 本 章 中 ， 我 们 将 学 习 Git 相关 的 基本 知识 与 操作 方法 。 已 经 将 Git 
实际 运用 于 开发 的 读者 大 可 跳 过 本 章 。 本 章 中 将 要 解说 的 ， 是 理解 本 书 
内 容 所 必 不 可 少 的 一 些 Git 操作 。 请 随 着 我 们 的 解说 ， 一 边 实际 操作 ， 
一 边 学 习 并 掌握 Git。 








4.1 基本 操作 


@ git init 一 一 初始 化 仓库 
要 使 用 Git 进行 版 本 管理 ， 必 须 先 初始 化 仓库 。Git 是 使 用 git 
init 命 令 进行 初始 化 的 。 请 实际 建立 一 个 目录 并 初始 化 仓库 。 


$ mkdir git-tutorial 








$ cd git-tutorial 

$ git init 

Initialized empty Git repository in /Users/hirocaster/github/github-book 
/git-tutorial/.git/ 


如 果 初 始 化 成 功 ， 执 行 了 git init 命 令 的 目录 下 就 会 生成 git H 
录 。 这 个 .git 目录 里 存储 着 管理 当前 目录 内 容 所 需 的 仓库 数据 。 

在 Git 中 ,我 们 将 这 个 目录 的 内 容 称 为 “附属 于 该 仓库 的 工作 树 ”。 
文件 的 编辑 等 操作 在 工作 树 中 进行 ， 然 后 记录 到 仓库 中 ， 以 此 管理 文件 
的 历史 快照 。 如 果 想 将 文件 恢复 到 原先 的 状态 ， 可 以 从 仓库 中 调 取 之 前 
的 快照 ， 在 工作 树 中 打开 。 开 发 者 可 以 通过 这 种 方式 获取 以 往 的 文件 。 
具体 操作 指令 我 们 将 在 后 面 详细 解说 。 














I 















































0 git status 一 一 查看 仓库 的 状态 


git status 命 令 用 于 显示 Git 仓库 的 状态 。 这 是 一 个 十 分 常用 的 
命令 ， 请 务必 牢记 。 

工作 树 和 仓库 在 被 操作 的 过 程 中 ， 状 态 会 不 断 发 生变 化 。 在 Git 操 
作 过 程 中 时 常用 git status 命 令 查看 当前 状态 ， 可 谓 基本 中 的 基本 。 
下 面 ， 就 让 我 们 来 实际 查看 一 下 当前 状态 。 
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$ git status 

# On branch master 

# 

# Initial commit 

# 

nothing to commit (create/copy files and use "git add" to track) 


结果 显示 了 我 们 当前 正 处 于 master 分 支 下 。 关 于 分 支 我 们 会 在 不 久 
后 讲 到 ， 现 在 不 必 深 究 。 接 着 还 显示 了 没有 可 提交 的 内 容 。 所 谓 提交 
( Commit )， 是 指 “ 记 录 工 作 树 中 所 有 文件 的 当前 状态 ”。 

尚 没 有 可 提交 的 内 容 ， 就 是 说 当前 我 们 建立 的 这 个 仓库 中 还 没有 记 
录 任 何 文件 的 任何 状态 。 这 里 ， 我 们 建立 README.md 文件 作为 管理 对 
象 ， 为 第 一 次 提交 做 前 期 准备 。 


$ touch README.md 
$ git status 
































4 On branch master 

# 

# Initial commit 

## Untracked files:# (use "git add <file>..." to include in what will 
be committed) # 

# README .md 

nothing added to commit but untracked files present (use "git add" to 
track) 


可 以 看 到 在 Untracked files 中 显示 了 README.md 文件 。 类 似 地 ， 
只 要 对 Git 的 工作 树 或 仓库 进行 操作 ，git status 命 令 的 显示 结果 就 
会 发 生变 化 。 














添加 文件 


如 果 只 是 用 Git 仓库 的 工作 树 创建 了 文件 ， 那 么 该 文件 并 不 会 被 记 
A Git 仓库 的 版 本 管理 对 象 当中 。 因 此 我 们 用 git status 命 令 查看 
README.md 文件 时 ， 它 会 显示 在 Untracked files 里 。 

要 想 让 文件 成 为 Git 仓库 的 管理 对 象 ， 就 需要 用 git add 命 令 将 其 
加 入 暂 存 区 ( Stage 或 者 Index ) 中 。 Nonius 六 域 。 


$ git add README.md 
$ git status 





















































# On branch master 
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Initial commit 


Changes to be committed: 


(use "git rm --cached <file>..." to unstage) 


new file: README.md 





将 README.md 文件 加 入 暂 存 区 后 ，git status 命 令 的 显示 结 
发 生 了 变化 。 可 以 看 到 ，README.md 文件 显示 在 Changes to be 
committed 中 了 。 














€ git commit 一 一 保存 仓库 的 历史 记录 


git _ commit 命令 可 以 将 当前 暂 存 区 中 的 文件 实际 保存 到 仓库 的 历 
史记 录 中 。 通 过 这 些 记 录 ， 我 们 就 可 以 在 工作 树 中 复原 文件 。 





e 记述 一 行 提 交 信 息 


我 们 来 实际 运行 一 下 git _ commit 命令 。 


$ git commit -m "First commit" 

[master (root-commit) 9f129ba] First commit 
1 file changed, 0 insertions(+), 0 deletions(-) 
create mode 100644 README.md 


-m 参数 后 的 "First commit" 称 作 提 交 信息 ， 是 对 这 个 提交 的 





i 述 详细 提交 信息 


TER 


9] r3] EL fer iiis f —fr965cfzi B, TURA EORR Um 
细 ， 请 不 加 -m， 直 接 执行 git commit 命令。 执行 后 编辑 器 就 会 启 
动 ， 并 显示 如 下 结果 。 


Please enter the commit message for your changes. Lines starting 




















with '#' will be ignored, and an empty message aborts the commit. 
On branch master 








Initial commit 
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# 

# Changes to be committed: 

# (use "git rm --cached <file>..." to unstage) 
# 

# new file: README. md 

# 





在 编辑 器 中 记述 提交 信息 的 格式 如 下 。 























。 第 一 行 : 用 一 行文 字 简 述 提交 的 更 改 内 容 
。 第 二 行 : 空 行 
e 第 三 行 以 后 : 记述 更 改 的 原因 和 详细 内 容 








只 要 按照 上 面 的 格式 输入 ,今后 便 可 以 通过 确认 日 志 的 命令 或 工具 
看 到 这 些 记录 。 

在 以 # (Jl) 标 为 注释 的 Changes to be committed (要 提 
交 的 更 改 ) 栏 中 ， 可 以 查看 本 次 提交 中 包含 的 文件 。 将 提交 信息 按 格 式 
记述 完毕 后 ， 请 保存 并 关闭 编辑 器 ， 以 # ( 井 号 ) 标 为 注释 的 行 不 必 删 
除 。 随 后 ， 刚 才 记述 的 提交 信息 就 会 被 提交 。 






































如 果 在 编辑 器 启动 后 想 中 止 提 交 ， 请 将 提交 信息 留 空 并 直接 关闭 编 
辑 需 ， 随 后 提交 就 会 被 中 止 。 

















@…… 查看 提交 后 的 状态 


执行 完 git commit 命 令 后 再 来 查看 当前 状态 。 


$ git status 
# On branch master 


nothing to commit, working directory clean 


当前 工作 树 处 于 刚刚 完成 提交 的 最 新 状态 ， 所 以 结果 显示 没有 更 改 。 




















@ git log 一 一 查看 提交 日 志 
git 1og 命 令 可 以 查看 以 往 仓 库 中 提交 的 日 志 。 包 括 可 以 查看 什 
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么 人 在 什么 时 候 进 行 了 提交 或 合并 ， 以 及 操作 前 后 有 怎样 的 差别 。 关 于 
合并 我 们 会 在 后 面 解说 。 
我 们 先 来 看 看 刚才 的 git commit 命令 是 否 被 记录 了 。 


$ git log 

















commit 9f129bae19b2c82fb4e98cde5890e52a6c546922 
Author: hirocaster <hohtsuka@gmail .com> 
Date: Sun May 5 16:06:49 2013 +0900 


First commit 


如 上 图 所 示 ， 屏 幕 显 示 了 刚刚 的 提交 操作 。commit 栏 旁 边 显 示 的 
“9f129b……” 是 指向 这 个 提交 的 哈 希 值 。Git 的 其 他 命令 中 ， 在 指向 提 
交 时 会 用 到 这 个 哈 希 值 。 

Author 栏 中 显示 我 们 给 Git 设置 的 用 户 名 和 邮箱 地 址 。Date 栏 中 显 
示 提 交 执 行 的 日 期 和 时 间 。 再 往 下 就 是 该 提交 的 提交 信息 。 



































如 果 只 想 让 程序 显示 第 一 行 简 述 信息 ， 可 以 在 git 1og 命 令 后 加 
y=short。 这 样 一 来 开发 人 员 就 能 够 更 轻松 地 把 握 多 个 
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$ git log --pretty-short 


commit 9f129bael19b2c82fb4e98cde5890e52a6c546922 
Author: hirocaster «hohtsukaegmail.com» 


First commit 


e 只 显示 指 定 目录 、 文件 的 日 志 


只 要 在 git 1og 命 令 后 加 上 目录 名 ， 便 会 只 显示 该 目录 下 的 日 志 。 
如 果 加 的 是 文件 名 ， 就 会 只 显示 与 该 文件 相关 的 日 志 。 


$ git log README.md 
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o- 显示 文件 的 改动 
如 果 想 查看 提交 所 带 来 的 改动 ， 可 以 加 上 -p 参 数 ， 文 件 的 前 后 差 


别 就 会 显示 在 提交 信息 之 后 。 
$ git log -p 
比如 ， 执 行 下 面 的 命令 ， 就 可 以 只 查看 README.md 文件 的 提交 日 
志 以 及 提交 前 后 的 差别 。 
$ git log -p README.md 
WEIR, git 1og 命 令 可 以 利用 多 种 参数 帮助 开发 者 把 握 以 往 
提交 的 内 容 。 不 必 钢 强 自己 一 次 记 下 全 部 参数 ， 每 当 有 和 想 查 看 的 日 志 就 
积极 去 查 ， 慢 慢 就 能 得 心 应 手 了 。 
































@ git diff 一 查看 更 改 前 后 的 差别 
git diff 命 令 可 以 查看 工作 树 、 暂 存 区 、 最 新 提交 之 间 的 差别 。 
单 从 字面 上 可 能 很 难 理解 ， 各 位 不 妨 跟 着 笔者 的 解说 亲手 试 一 试 。 
我 们 在 刚刚 提交 的 README.md 中 写 点 东西 。 


# Git 教 程 






































这 里 用 Markdown 语法 写 下 了 一 行 题目 。 





o- 查看 工作 树 和 暂 存 区 的 差别 
执行 git qiff 命 令 , 查看 当前 工作 树 与 暂 存 区 的 差别 。 


$ git diff 





diff --git a/README.md b/README.md 
index e69de29..cb5dc9f 100644 
-- a/README.md 
+++ b/README.md 
@@ -0,0 41 Ge 
+# Git 教 程 














由 于 我 们 尚未 用 git adgd 命 令 向 暂 存 区 添加 任何 东西 ， 所 以 程序 
只 会 显示 工作 树 与 最 新 提交 状态 之 间 的 差别 。 
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这 里 解释 一 下 显示 的 内 容 。 “+” 号 标 出 的 是 新 添加 的 行 ， 被 删除 的 
行 则 用 “-” 号 标 出 。 我 们 可 以 看 到 ， 这 次 只 添加 了 一 行 。 
JH git adq 命 令 将 README.md 文件 加 入 暂 存 区 。 


$ git add README.md 





e-— 查看 工作 树 和 最 新 提交 的 差别 


如 果 现 在 执行 git diff 命 令 ， 由 于 工作 树 和 和 暂 存 区 的 状态 并 无 
差别 ， 结 果 什 么 都 不 会 显示 。 要 查看 与 最 新 提交 的 差别 ， 请 执行 以 下 


























$ git diff HEAD 

diff --git a/README.md b/README.md 
index e69de29..cb5dc9f 100644 

--- a/README.md 

+++ b/README.md 

@@ -0,0 «1 @@ 

+# Git 教 程 


不 妨 养 成 这 样 一 个 好 习惯 : 在 执行 git commit 命 令 之 前 先 执行 
git diff HEAD 命 令 ， 查 看 本 次 提交 与 上 次 提交 之 间 有 什么 差别 ， 等 
确认 完毕 后 再 进行 提交 。 这 里 的 HEAD 是 指向 当前 分 支 中 最 新 一 次 提交 
的 指针 。 
由 于 我 们 刚刚 确认 过 两 个 提交 之 间 的 差别 ， 所 以 直接 运行 git 


commit. 












































$ git commit -m "Add index" 
[master fd0cbf0] Add index 
1 file changed, 1 insertion(-) 


保险 起 见 ， 我 们 查看 一 下 提交 日 志 ， 确 认 提 交 是 否 成 功 。 


$ git log 

commit fd0cbf0d4a25f747230694d95caclbe72d33441d 
Author: hirocaster «hohtsukaGegmail.com» 

Date: Sun May 5 16:10:15 2013 +0900 


Add index 


commit 9f129bae19b2c82fb4e98cde5890e52a6c546922 
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Author: hirocaster «hohtsukaGegmail.com» 
Date: Sun May 5 16:06:49 2013 +0900 


First commit 


成 功 查 到 了 第 二 个 提交 。 
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在 进行 多 个 并 行 作业 时 ， 我 们 会 用 到 分 支 。 在 这 类 并 行 开发 的 过 程 
中 ， 往 往 同时 存在 多 个 最 新 代码 状态 。 如 图 4.1 所 示 ， 从 master 分 支 创 
f£ feature-A 分 支 和 fix-B 分 文 后 ， 每 个 分 文中 都 拥有 自己 的 最 新 代码 。 
master 分 支 是 Git 默认 创建 的 分 支 ， 因 此 基本 上 所 有 开发 都 是 以 这 个 分 
支 为 中 心 进行 的 。 

图 4.1 从 master 分 支 创建 feature-A 分 支 和 fix-B 分 支 


feature-A C O fix-B 


不 同 分 支 中 ， 可 以 同时 进行 完全 不 同 的 作业 。 等 该 分 支 的 作业 完成 
之 后 再 与 master 分 支 合并 。 比 如 feature-A 分 支 的 作业 结束 后 与 master 
合并 ， 如 图 42 所 示 。 

通过 灵活 运用 分 支 ， 可 以 让 多 人 同时 高 效 地 进行 并 行 开发 。 在 这 
里 ， 我 们 将 带 大 家 学 习 与 分 支 相关 的 Git 操作 。 
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图 4.2 “feature-A 分 支 作 业 结 束 后 的 状态 
master( ) 


feature-A s 
Ó loe 


Ó 


€ git branch 一 一 显示 分 支 一 览 表 


git branch 命 令 可 以 将 分 支 名 列表 显示 ， 同 时 可 以 确认 当前 所 在 
分 文 。 让 我 们 来 实际 运行 git branch 命 令 。 


$ git branch 

















* master 


可 以 看 到 master 分 支 左 侧 标 有 “*”( 星 号 )， 表 示 这 是 我 们 当前 所 
在 的 分 支 。 也 就 是 说 ， 我 们 正在 master 分 支 下 进行 开发 。 结 果 中 没有 显 
示 其 他 分 支 名 ， 表 示 本 地 仓库 中 只 存在 master —1 T xc. 














€ git checkout -b 一 一 创建 、 切 换 分 支 
如 果 想 以 当前 的 master 分 支 为 基础 创建 新 的 分 支 ， 我 们 需要 用 到 


git checkout -b 命 今 。 








@…… 切换 到 feature-A 分 支 并 进行 提交 
执行 下 面 的 命令 ， 创 建 名 为 feature-A 的 分 支 。 


$ git checkout -b feature-A 














Switched to a new branch 'feature-A' 
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实际 上 ， 连 续 执 行 下 面 两 条 命令 也 能 收 到 同样 效果 。 


$ git branch feature-A 
$ git checkout feature-A 


创建 feature-A 分 支 ， 并 将 当前 分 支 切换 为 feature-A 分 支 。 这 时 再 
来 查看 分 支 列表 ， 会 显示 我 们 处 于 feature-A 分 支 下 。 


$ git branch 
* feature-A 
master 


feature-A 分 支 左 侧 标 有 “*”， 表 示 当 前 分 支 为 feature-A。 在 这 个 状 
态 下 像 正 常 开发 那样 修改 代码 、 执 行 git add 命令 并 进行 提交 的 话 ， 
代码 就 会 提交 至 feature-A 分 支 。 像 这 样 不 断 对 一 个 分 支 ( 例 如 
feature-A ) 进行 提交 的 操作 ， 我 们 称 为 “培育 分 支 ”。 
下 面 来 实际 操作 一 下 。 在 README.md 文件 中 添加 一 行 。 
# Git 教 程 



































- feature-A 


这 里 我 们 添加 了 feature-A 这 样 一 行 字母 ， 然 后 进行 提交 。 


$ git add README.md 
$ git commit -m "Add feature-A" 
[feature-A 8a6c8b9] Add feature-A 


1 file changed, 2 insertions (+) 


于 是 ， 这 一 行 就 添加 到 feature-A 分 支 中 了 。 





@…… 切换 到 master 分 支 


现在 我 们 再 来 看 一 看 master 分 支 有 没有 受到 影响 。 首 先 切换 至 
master 分 支 。 


$ git checkout master 





Switched to branch 'master' 





然后 查看 README.md 文件 ， 会 发 现 README.md 文件 仍然 保持 
原先 的 状态 ， 并 没有 被 添加 文字 。feature-A 分 支 的 更 改 不 会 影响 到 
master 分 支 ， 这 正 是 在 开发 中 创建 分 支 的 优点 。 只 要 创建 多 个 分 支 ， 就 
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可 以 在 不 互相 影响 的 情况 下 同时 进行 多 个 功能 的 开发 。 
e— 切换 回 上 一 个 分 支 
现在 ， 我 们 再 切换 回 feature-A 分 支 。 


$ git checkout - 
Switched to branch 'feature-A' 


像 上 面 这 样 用 “-”( 连 字符 ) 代替 分 支 名 ， 就 可 以 切换 至 上 一 个 分 
支 。 当 然 , 将 “-” 替 换 成 feature-A 同样 可 以 切换 到 feature-A 分 支 。 














@ 特性 分 支 


Git 与 Subversion ( SVN ) 等 集中 型 版 本 管理 系统 不 同 ， 创 建 分 支 时 
不 需要 连接 中 央 仓 库 ， 所 以 能 够 相对 轻松 地 创建 分 支 。 因 此 ， 当 今 大 部 
分 工作 流程 中 都 用 到 了 特性 (Topic) 分 支 。 

特性 分 支 顾名思义 ， 是 集中 实现 单一 特性 (主题 )， 除 此 之 外 不 进 
行 任何 作业 的 分 支 。 在 日 常 开发 中 ,往往 会 创建 数 个 特性 分 支 ， 同 时 在 
此 之 外 再 保留 一 个 随时 可 以 发 布 软件 的 稳定 分 支 。 稳 定 分 支 的 角色 通常 
由 master 分 支 担 当 (图 4.3 )。 


4.3 ”特性 分 支 的 概念 


























master 


^5 feature-A 
特性 分 支 











之 前 我 们 创建 了 feature-A 分 支 ， 这 一 分 支 主要 实现 feature-A， 除 
feature-A 的 实现 之 外 不 进行 任何 作业 。 即 便 在 开发 过 程 中 发 现 了 BUG, 
也 需要 再 创建 新 的 分 支 ， 在 新 分 支 中 进行 修正 。 
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基于 特定 主题 的 作业 在 特性 分 支 中 进行 ， 主 题 完成 后 再 与 master 分 
支 合并 。 只 要 保持 这 样 一 个 开发 流程 ， 就 能 保证 master 分 文 可 以 随时 供 
人 查看 。 这 样 一 来 ， 其 他 开发 者 也 可 以 放心 大 胆 地 从 master 分 文 创建 新 
的 特性 分 支 。 








e 主干 分 支 


主干 分 支 是 刚才 我 们 讲解 的 特性 分 支 的 原点 ， 同 时 也 是 合并 的 终 
点 。 通 常人 们 会 用 master 分 支 作为 主干 分 文 。 主 干 分 支 中 并 没有 开发 到 
一 半 的 代码 ， 可 以 随时 供 他 人 查看 。 

有 时 我 们 需要 让 这 个 主干 分 支 总 是 配置 在 正式 环境 中 ， 有 时 又 需要 
] 标 签 Tag 等 创建 版 本 信息 ， 同 时 管理 多 个 版 本 发 布 。 拥 有 多 个 版 本 发 
布 时 ， 主 干 分 支 也 有 多 个 。 















































0 git merge 一 一 合并 分 支 


接 下 来 我们 假设 feature-A 已 经 实现 完毕 ， 想 要 将 它 合 并 到 主干 分 
文 master 中 。 首 先 切换 到 master 分 文 。 


$ git checkout master 








Switched to branch 'master' 

















然后 合并 feature-A 分 支 。 为 了 在 历史 记录 中 明确 记录 下 本 次 分 支 合 
并 ， 我 们 需要 创建 合并 提交 。 因 此 ， 在 合并 时 加 上 - -no-ff 参 数 。 
$ git merge ~ -notf featuré-A 

随后 编辑 器 会 启动 ， 用 于 录入 合并 提交 的 信息 。 


Merge branch 'feature-A' 






































# Please enter a commit message to explain why this merge is necessary, 
4 especially if it merges an updated upstream into a topic branch. 

# 

# Lines starting with '#' will be ignored, and an empty message aborts 
# the commit. 








默认 信息 中 已 经 包含 了 是 从 feature-A 分 支 合 并 过 来 的 相关 内 容 ， 所 
以 可 不 必 做 任何 更 改 。 将 编辑 咒 中 显示 的 内 容 保存 ， 关 闭 编 辑 咒 ， 然 后 
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就 会 看 到 下 面 的 结果 。 


Merge made by the 'recursive' strategy. 
README.md | 2 ++ 


1 file changed, 2 insertions(+) 


这 样 一 来 ，feature-A 分 支 的 内 容 就 合并 到 master 分 支 中 了 。 











@ git log --graph 一 一 以 图 表 形 式 查看 分 支 

用 git log --graph 命 令 进行 查看 的 话 ， 能 很 清楚 地 看 到 特性 
分 支 ( feature-A ) 提交 的 内 容 已 被 合并 。 除 此 以 外 ， 特 性 分 支 的 创建 以 
及 合并 也 都 清楚 明了 。 


$ git log --graph 


2 











5 commit 83b0b94268675cb715ac6c8a5bc1965938c15f62 
\ Merge: fd0cbf0 8a6c8b9 

Author: hirocaster «hohtsukaGgmail.com» 

Date: Sun May 5 16:37:57 2013 40900 


Merge branch 'feature-A' 


r—— 


commit 8a6c8b97c8962cd44afb69c65f26d6ela6c088d8 
/ Author: hirocaster «hohtsukaGgmail.com» 
Date: Sun May 5 16:22:02 2013 +0900 


Add feature-A 
* commit fd0cbf0d4a25f747230694d95caclbe72d33441d 
Author: hirocaster «hohtsukaegmail.com- 


Date: Sun May 5 16:10:15 2013 +0900 


Add index 





* commit 9f129bael19b2c82fb4e98cde5890e52a6c546922 
Author: hirocaster «hohtsukaegmail.com- 
Date: Sun May 5 16:06:49 2013 +0900 


First commit 


git log --graph 命 令 可 以 用 图 表 形 式 输出 提交 日 志 ， 非 常 直 
观 ， 请 大 家 务必 记 住 。 
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4.3 ”更 改 提交 的 操作 


@ git reset 一 一 回溯 历史 版 本 

通过 前 面 学 习 的 操作 ， 我 们 已 经 学 会 如 何在 实现 功能 后 进行 提交 ， 
累积 提交 日 志 作 为 历史 记录 ， 借 此 不 断 培育 一 款 软 件 。 

Git 的 另 一 特征 便 是 可 以 灵活 操作 历史 版 本 。 借 助 分 散 仓库 的 优势 ， 
可 以 在 不 影响 其 他 仓库 的 前 提 下 对 历史 版 本 进行 操作 。 

在 这 里 ， 为 了 让 各 位 熟悉 对 历史 版 本 的 操作 ， 我 们 先 回 溯 历 史 版 
本 ， 创 建 一 个 名 为 fix-B 的 特性 分 支 (图 4.4 )。 


图 4.4 “回溯 历史 ,创建 fix-B 分 支 
































master 


feature-A d O fix-B 


@…… 回溯 到 创建 feature-A 分 支 前 


让 我 们 先 回溯 到 上 一 节 feature-A 分 支 创建 之 前 ， 创 建 一 个 名 为 
fix-B 的 特性 分 文 。 

要 让 仓库 的 HEAD、 暂 存 区 、 当 前 工作 树 回 溯 到 指定 状态 ， 需 要 用 
到 git rest --hard 命 令 。 只 要 提供 目标 时 间 点 的 哈 希 值 “， 就 可 以 



































(D 哈 希 值 在 每 个 环境 中 各 不 相同 ， 读 者 请 查看 自身 当前 环境 中 Add index 的 哈 希 值 ， 
进行 替换 。 
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完全 恢复 至 该 时 间 点 的 状态 。 事 不 宜 迟 ， 让 我 们 执行 下 二 


-hard fd0cbf0d4a25f747230694d95caclbe72d33441d 





S git reset =< 
HEAD is now at fdOcbfO Add index 


3418.25 EHE REA 3C ( feature-A ) 创建 之 前 的 状态 。 由 于 
所 有 文件 都 回溯 到 了 指定 哈 希 值 对 应 的 时 间 点 上 ，README.md 文件 的 
内 容 也 恢复 到 了 当时 的 状态 。 








e- 创建 fix-B 分 支 
现在 我 们 来 创建 特性 分 支 ( fix-B )。 


$ git checkout -b fix-B 
Switched to a new branch 'fix-B' 


作为 这 个 主题 的 作业 内 容 ， 我 们 在 README.md 文件 中 添加 一 行 


文字 。 
# Git 教 程 








- fix-B 


然后 直接 提交 README.md 文件 。 





$ git add README.md 


$ git commit -m "Fix B" 
[fix-B 4096d9e] Fix B 
1 file changed, 2 insertions (+) 


现在 的 状态 如 图 4.5 所 示 。 接 下 来 我 们 的 目标 是 图 4.6 中 所 示 的 状 
态 ， 即 主干 分 支 合 并 feature-A 分 支 的 修改 后 ， 又 合并 了 fix-B 的 修改 。 








4.5 “当前 fix-B 分 支 的 状态 





O fix-B 


Ka 
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图 4.6 “fix-B 分 支 的 下 一 步 目 标 





master 


feature-A d fix-B 


@…… 推进 至 feature-A 分 支 合 并 后 的 状态 


首先 恢复 到 feature-A 分 支 合 并 后 的 状态 。 不 妨 称 这 一 操作 为 “ 推 
PE” 

git 1og 命 令 只 能 查看 以 当前 状态 为 终点 的 历史 日 志 。 所 以 这 里 
要 使 用 git ref1log 命 令 , 查看 当前 仓库 的 操作 日 志 。 在 日 志 中 找 出 
回溯 历史 之 前 的 哈 希 值 ， 通过 git reset --hard 命 令 恢 复 到 回溯 历 
史前 的 状态 。 
首先 执行 git reflog 命令 ， 查 看 当前 仓库 执行 过 的 操作 的 日 志 。 


$ git reflog 
4096d9e HEAD@{0 
fdq0cbf0 HEAD@{1 
fd0cbf0 HEAD@{2 
83b0b94 HEAD@{3 
fd0cbf0 HEAD@{4 
5 
6 














BE 




















: commit: Fix B 

: checkout: moving from master to fix-B 

: reset: moving to fd0cbf0d4a25f747230694d95caclbe72d33441d 
: merge feature-A: Merge made by the 'recursive' strategy. 

: checkout: moving from feature-A to master 

8a6c8b9 HEADG 
fdq0cbf0 HEADG 
8a6c8b9 HEADG|7 
fd0cbf0 HEAD@{8 
fdq0cbf0 HEAD@{9 
9f129ba HEAD@{1 Jm commit (initial): First commit 


: checkout: moving from feature-A to master 
: commit: Add feature-A 





: checkout: moving from master to feature-A 





: commit: Add index 





} 
} 
} 
} 
} 
}: checkout: moving from master to feature-A 
} 
} 
} 
} 
0 
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在 日 志 中 ， 我 们 可 以 看 到 commit, checkout, reset, merge 等 Git 命 
令 的 执行 记录 。 只 要 不 进行 Git 的 GC ( Garbage Collection， 垃 圾 回收 )， 
就 可 以 通过 日 志 随 意 调 取 近 期 的 历史 状态 ， 就 像 给 时 间 机 器 指定 一 个 时 
间 点 ， 在 过 去 未 来 中 自由 穿梭 一 般 。 即 便 开 发 者 错误 执行 了 Git 操作， 
基本 也 都 可 以 利用 git zef1log 命 令 恢复 到 原先 的 状态 ， 所 以 请 各 位 
读者 务必 牢记 本 部 分 。 

从 上 面 数 第 四 行 表示 feature-A 特性 分 支 合并 后 的 状态 ， 对 应 哈 希 值 
为 83b0b94”。 我 们 将 HEAD, HHK, 工作 树 恢复 到 这 个 时 间 点 的 状态 。 


$ git checkout master 











$ git reset --hard 83b0b94 
HEAD is now at 83b0b94 Merge branch 'feature-A' 


之 前 我 们 使 用 git reset --hardfp/ [nr Djs, KELER 
通过 它 恢复 到 了 回溯 前 的 历史 状态 。 当 前 的 状态 如 图 4.7 所 示 。 


47 “恢复 历史 后 的 状态 























master 


feature-A C fix-B 


e 消除 冲突 


现在 只 要 合并 fix-B 分 支 ， 就 可 以 得 到 我 们 想 要 的 状态 。 让 我 们 赶 
快 进行 合并 操作 。 

















D 哈 希 值 只 要 输入 4 位 以 上 就 可 以 执行 。 
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$ git merge --no-ff fix-B 

Auto-merging README .md 

CONFLICT (content): Merge conflict in README.md 
Recorded preimage for 'README.md' 


Automatic merge failed; fix conflicts and then commit the result. 





这 时 ， 系 统 告诉 我 们 README.md 文件 发 生 了 冲突 (Conflict) % 
统 在 合并 README.md 文件 时 ，feature-A 分 支 更 改 的 部 分 与 本 次 想 要 合 
并 的 fix-B 分 支 更 改 的 部 分 发 生 了 冲突 。 

不 解决 冲突 就 无 法 完成 合并 ， 所 以 我 们 打开 README.md 文件 ， 解 
决 这 个 冲突 。 








@…… 查看 冲突 部 分 并 将 其 解决 
j 编 辑 器 打开 README.md 文件 ， 就 会 发 现 其 内 容 变 成 了 下 面 这 个 




















样子 。 


Git 教 程 





<<<<<<< HEAD 
- feature-A 


- fix-B 











======= 以 上 的 部 分 是 当前 HEAD 的 内 容 ， 以 下 的 部 分 是 要 合并 
的 fix-B 分 支 中 的 内 容 。 我 们 在 编辑 器 中 将 其 改 成 想 要 的 样子 。 


# Git 教 程 








- feature-A 
- fix-B 


如 上 所 示 ， 本 次 修正 让 feature-A 5 fix-B 的 内 容 并 存 于 文件 之 中 。 
但 是 在 实际 的 软件 开发 中 ， 往 往 需要 删除 其 中 之 一 ， 所 以 各 位 在 处 理 冲 
突 时 ， 务 必要 仔细 分 析 冲 突 部 分 的 内 容 后 青 行 修改 。 











Ņ 


@…… 提交 人 解决 后 的 结果 


冲突 解决 后 ， 执 行 git adgd 命 令 与 git commit 命 令 。 
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$ git add README.md 


$ git commit -m "Fix conflict" 
Recorded resolution for 'README.md'. 
[master 6a97e48] Fix conflict 











由 于 本 次 更 改 解决 了 冲突 ， 所 以 提交 信息 记 为 "Fix conflict" 。 


@ git commit --amend 一 一 修改 提交 信息 














要 修改 上 一 条 提交 信息 ， 可 以 使 用 git commit --amend 命 令 。 

我 们 将 上 一 条 提交 信息 记 为 了 "Fix conflict"， 但 它 其 实 是 fix-B 分 
支 的 合并 ， 解 决 合 并 时 发 生 的 冲突 只 是 过 程 之 一 ， 这 样 标记 实在 不 妥 。 
于 是 ， 我 们 要 修改 这 条 提交 信息 。 


$ git commit --amend 


执行 上 面 的 命令 后 ， 编 辑 器 就 会 启动 。 


Fix conflict 





















































Please enter the commit message for your changes. Lines starting 
with '#' will be ignored, and an empty message aborts the commit. 
On branch master 

Changes to be committed: 


(use "git reset HEAD^l <file>..." to unstage) 


modified: README.md 

















编辑 器 中 显示 的 内 容 如 上 所 示 ， 其 中 包含 之 前 的 提交 信息 。 请 将 
提交 信息 的 部 分 修改 为 Merge branch 'fix-B'， 然 后 保存 文件 ， 关 闭 编 
pro 


[master 2e7db6f] Merge branch 'fix-B' 



































随后 会 显示 上 面 这 条 结果 。 现 在 执行 git log --graphfr?, 
可 以 看 到 提交 日 志 中 的 相应 内 容 也 已 经 被 修改 。 


$ git log --graph 


* commit 2e7db6fb0b576e9946965ea680e4834ee889c9d8 
|\ Merge: 83b0b94 4096d9e 


图 灵 社 区 会 员 lxghost2 专 享 尊重 版 权 





59 





43 ”更 改 提 交 的 操作 


Author: hirocaster <hohtsuka@gmail .com> 
Date: Sun May 5 16:58:27 2013 40900 


Merge branch 'fix-B' 


* commit 4096d9e856995alaafa982aabb52bfc0da656b74 
Author: hirocaster «hohtsukaGgmail.com» 
Date: Sun May 5 16:50:31 2013 +0900 


Fix B 


d commit 83b0b94268675cb715ac6c8a5bc1965938c15f62 


\ V Merge: fd0cbf0 8a6c8b9 
/ Author: hirocaster «hohtsukaGgmail.com» 
/ Date: Sun May 5 16:37:57 2013 +0900 


Merge branch 'feature-A' 





* commit 8a6c8b97c8962cd44afb69c65f26d6ela6c088d8 
/ Author: hirocaster «hohtsukaGgmail.com» 
Date: Sun May 5 16:22:02 2013 +0900 


Add feature-A 


* commit fd0cbf0d4a25f747230694d95caclbe72d33441d 
Author: hirocaster «hohtsukaGgmail.com» 
Date: Sun May 5 16:10:15 2013 +0900 


Add index 





* commit 9f129bae19b2c82fb4e98cde5890e52a6c546922 
Author: hirocaster «hohtsukaGgmail.com» 
Bases Sun May 5 16:06:49 2013 +0900 


First commit 





0 git rebase 


在 合并 特性 分 支 之 前 ， 如 果 发 现 已 提交 的 内 容 中 有 些许 拼写 错误 等 ， 
TIE TES 然后 将 这 个 修改 包含 到 前 一 个 提交 之 中 ， 压 缩 成 一 
个 历史 记录 。 这 是 个 会 经 常用 到 的 技巧 ， 让 我 们 来 实际 操作 体会 一 下 。 





e 创建 feature-C 分 支 
首先 ， 新 建 一 个 feature-C 特性 分 支 。 
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$ git checkout -b feature-C 


Switched to a new branch 'feature-C' 

作为 feature-C 的 功能 实现 ， 我们 在 README.md 文件 中 添加 一 行 
文字 ， 并 且 故 意 留 下 拼写 错误 ， 以 便 之 后 修正 。 
# Git 教 程 








- feature-A 
- fix-B 


= faetüre-C 


提交 这 部 分 内 容 。 这 个 小 小 的 变更 就 没 必要 先 执行 git addq 命 令 
再 执行 git commit 命 令 了 , 我们 用 git commit -am 命令 来 一 次 
完成 这 两 步 操作 。 


$ git commit -am "Add feature-C" 
[feature-C 7a34294] Add feature-C 
1 file changed, 1 insertion(-) 


@…… 修 正 拼 写 错 误 


现在 来 修正 刚才 预 留 的 拼写 错误 。 请 各 位 自行 修正 README.md X 
F 的 内 容 ， 修 正 后 的 差别 如 下 所 示 。 


$ git diff 

diff --git a/README.md b/README.md 
index adl9aba..af647fd 100644 

--- a/README.md 

+++ b/README.md 

@@ -2,4 «2,4 @@ 








D 





= feature-A 
- fix-B 
= faeture- -C 
+ - feəture-C 
` MEZ FE Z2 
然后 进行 提交 。 





$ git commit -am "Fix typo" 
[feature-C 6fba227] Fix typo 
1 file changed, 1 insertion(«), 1 deletion(-) 


错字 漏 字 等 失误 称 作 typo， 所 以 我 们 将 提交 信息 记 为 "Fix typo"; 
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实际 上 ， 我 们 不 希望 在 历史 记录 中 看 到 这 类 提交 ， 因 为 健全 的 历史 记录 
并 不 需要 它们 。 如 果 能 在 最 初 提交 之 前 就 发 现 并 修正 这 些 错 误 ， 也 就 不 
会 出 现 这 类 提交 了 














因此 ， 我 们 来 更 改 历史 。 将 "Fix typo" 修 正 的 内 容 与 之 前 一 次 的 
提交 合并 ， 在 历史 记录 中 合并 为 一 次 完美 的 提交 。 为 此 ， 我 们 要 用 到 


git rebase 命 令 。 











$ git rebase -i HEAD-2 














上述 方式 执行 git rebase 命 令 ， 可 以 选 定 当 前 分 支 中 包含 
HEAD (最 新 提交 ) 在 内 的 两 个 最 新 历史 记录 为 对 象 ， 并 在 编辑 髓 中 
打开 。 


pick 7a34294 Add feature-C 
pick 6fba227 Fix typo 


























Rebase 2e7db6f..6fba227 onto 2e7db6f 


Commands: 

p, pick - use commit 

r, reword - use commit, but edit the commit message 

e, edit - use commit, but stop for amending 

S, squash - use commit, but meld into previous commit 

f, fixup - like "squash", but discard this commit's log message 
X, exec = run command (the rest of the line) using shell 


These lines can be re-ordered; they are executed from top to bottom. 
If you remove a line here THAT COMMIT WILL BE LOST. 


However, if you remove everything, the rebase will be aborted. 








Note that empty commits are commented out 


我 们 将 6fba227 的 Fix typo 的 历史 记录 压缩 到 7334294 的 Add feature-C 
里 。 按 照 下 图 所 示 ， 将 6fba227 左 侧 的 pick 部 分 删除 ， 改 写 为 fxup。 


pick 7a34294 Add feature-C 
fixup 6fba227 Fix typo 
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保存 编辑 器 里 的 内 容 ， 关 闭 编辑 器 。 


[detached HEAD 51440c5] Add feature-C 
1 file changed, 1 insertion(-) 








Successfully rebased and updated refs/heads/feature-C. 














系统 显示 rebase 成 功 。 也 就 是 以 下 面 这 两 个 提交 作为 对 象 ， 将 "Fix 
typo" 的 内 容 合并 到 了 上 一 个 提交 "Add feature-C" 中 ， 改 写成 了 一 个 新 


的 提交 。 

















® 7a34294 Add feature-C 
e 6fba227 Fix typo 


现在 再 查看 提交 日 志 时 会 发 现 Add feature-C 的 哈 希 值 已 经 不 是 
7a34204 了 ， 这 证 明 提 交 已 经 被 更 改 。 
$ git log graph 
* commit 51440c55b23fa7fa50aedf20aa43c54138171137 


Author: hirocaster <hohtsuka@gmail.com> 
Date: Sun May 5 17:07:36 2013 +0900 


Add feature-C 

* commit 2e7db6fb0b576e9946965ea680e4834ee889c9d8 
\ Merge: 83b0b94 4096d9e 

Author: hirocaster «hohtsukaGegmail.com» 


Date: Sun May 5 16:58:27 2013 +0900 


Merge branch 'fix-B' 


* 


commit 4096d9e856995alaafa982aabb52bfc0da656b74 
Author: hirocaster «hohtsukaGegmail.com» 
Date: Sun May 5 16:50:31 2013 +0900 


Fix B 








省 略 


这 样 一 来 ，Fix typo 就 从 历史 中 被 抹 去 ， 也 就 相当 于 Add feature-C 
中 从 来 没有 出 现 过 拼写 错误 。 这 算是 一 种 良性 的 历史 改写 。 
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e 合并 至 master 4 x 
feature-C 分 支 的 使 命 告 一 段落 ， 我 们 将 它 与 master 分 支 合并 。 


$ git checkout master 
Switched to branch 'master' 


$ git merge --no-f£ feature C 
Merge made by the 'recursive' strategy. 
README.md | 1 + 


1 file changed, 1 insertion(+) 


master 分 支 整 合 了 feature-C 分 支 。 开 发 进展 顺利 。 
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Git 是 分 散 型 版 本 管理 系统 ， 但 我 们 前 面 所 学 习 的 ， 都 是 针对 单一 
本 地 仓库 的 操作 。 下 面 ， 我 们 将 开始 接触 远 在 网 络 另 一 头 的 远程 仓 
库 。 远 程 仓 库 顾 名 思 义 ， 是 与 我 们 本 地 仓库 相对 独立 的 另 一 个 仓库 。 





























让 我 们 先 在 GitHub 上 创建 一 个 仓库 ， 并 将 其 设置 为 本 地 仓库 的 远程 





仓库 。 











T 





请 参考 第 3 章 的 3.2 节 在 GitHub 上 新 建 一 个 仓库 。 为 防止 与 其 他 仓 
库 混 消 ， 仓 库 名 请 与 本 地 仓库 保持 一 致 ， 即 git-tutorial。 创 建 时 请 不 要 

















勾 选 Initialize this repository with a README 选项 ( 图 4.8 )。 因 为 一 旦 勾 
选 该 选项 ，GitHub 一 侧 的 仓库 就 会 自动 生成 README 文件 ， 从 创建 之 
初 便 与 本 地 仓库 失去 了 整合 性 。 虽 然 到 时 也 可 以 强制 覆盖 ， 但 为 防止 这 














一 情况 发 生还 是 建议 不 要 勾 选 该 选项 ， 直 接点 击 Create repository 创建 


仓库 。 


图 4.8 — 不 要 勾 选 该 选项 








口 Initialize this repository with a README 
This will allow you to git clone the repository immediately. 


Add .gitignore: None v Add a license: None ~ 
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€ git remote add 一 一 添加 远程 仓库 


在 GitHub 上 创建 的 仓库 路 径 为 “gite@egithub .com: 用 户 名 / 
git-tutorial .git”。 现 在 我 们 用 git remote add 命令 将 它 设置 
成 本 地 仓库 的 远程 仓库 “。 


$ git remote add origin git@github.com:github-book/git-tutorial.git 








按照 上 述 格式 执行 sit remote add 命 令 之 后 ，Git 会 自动 将 
git@github.com:github-book/git-tutorial .git 远 程 仓库 的 
名 称 设置 为 origin ( 标识 符 )。 








€ git push 一 一 推送 至 远程 仓库 
@…… 推送 至 master 分 支 


如 果 想 将 当前 分 支 下 本 地 仓库 中 的 内 容 推送 给 远程 仓库 ,需要 用 到 
git push 命 令 。 现 在 假定 我 们 在 master 分 支 下 进行 操作 。 


$ git push -u origin master 














Counting objects: 20, done. 
Delta compression using up to 8 threads. 
Compressing objects: 100% (10/10), done. 
Writing objects: 100% (20/20), 1.60 KiB, done. 
Total 20 (delta 3), reused 0 (delta 0) 
To gitegithub.com:github-book/git-tutorial.git 
* [new branch] master -» master 
Branch master set up to track remote branch master from origin. 


像 这 样 执 行 git push 命令， 当前 分 支 的 内 容 就 会 被 推送 给 远程 仓库 
origin 的 master 分 支 。-u 参 数 可 以 在 推送 的 同时 ， 将 origin 仓库 的 master 分 
支 设置 为 本 地 仓库 当前 分 支 的 upstream (EYF) 添加 了 这 个 参数 ， 将 来 
运行 git pull 命 令 从 远程 仓库 获取 内 容 时 ， 本 地 仓库 的 这 个 分 支 就 可 
origin 的 master 分 支 获取 内 容 ， 省 去 了 另外 添加 参数 的 麻烦 。 

行 该 操作 后 ， 当 前 本 地 仓库 master 分 支 的 内 容 将 会 被 推送 到 
GitHub "e 远程 仓库 中 。 在 GitHub 上 也 可 以 确认 远程 master 21 3c HJ VJ 









































(OD 本 节 讲 解 中 使 用 的 用 户 名 为 github-book， 读 者 请 根据 自身 环境 予以 替换 。 
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和 本 地 master 分 支 相同 。 


Wie 推送 至 master 以 外 的 分 支 
除了 master 分 支 之 外 ， 远 程 仓库 也 可 以 创建 其 他 分 支 。 举 个 例子 ,我 
们 在 本 地 仓库 中 创建 feature-D 分 支 ， 并 将 它 以 同名 形式 push 至 远程 仓库 。 


$ git checkout -b feature-D 
Switched to a new branch 'feature-D' 

















我 们 在 本 地 仓库 中 创建 了 feature-D 分 支 ， 现 在 将 它 push 给 远程 仓 
库 并 保持 分 支 名 称 不 变 。 


$ git push -u origin feature-D 
Total 0 (delta 0), reused 0 (delta 0) 
To gitGgithub.com:github-book/git-tutorial.git 
* [new branch] feature-D -» feature-D 
Branch feature-D set up to track remote branch feature-D from origin. 








现在 ， 在 远程 仓库 的 GitHub 页 面 就 可 以 查看 到 feature-D 分 支 了 。 
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上 一 节 中 我 们 把 在 GitHub 上 新 建 的 仓库 设置 成 了 远程 仓库 ， 并 向 
这 个 仓库 push 了 feature-D 分 支 。 现 在 ， 所 有 能 够 访问 这 个 远程 仓库 的 
人 都 可 以 获取 feature-D 分 支 并 加 以 修改 。 

本 节 中 我 们 从 实际 开发 者 的 角度 出 发 ， 在 另 一 个 目录 下 新 建 一 个 本 
地 仓库 ， 学 习 从 远程 仓库 获取 内 容 的 相关 操作 。 这 就 相当 于 我 们 刚刚 执 
行 过 push 操作 的 目标 仓库 又 有 了 另 一 名 新 开发 者 来 共同 开发 。 
































€ git clone 一 一 获取 远程 仓库 
| 获取 远程 仓库 
首先 我 们 换 到 其 他 目录 下 ,将 GitHub 上 的 仓库 clone 到 本 地 。 注 意 
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不 要 与 之 前 操作 的 仓库 在 同一 目录 下 。 


$ git clone git@github.com:github-book/git-tutorial.git 
Cloning into 'git-tutorial'... 

remote: Counting objects: 20, done. 

remote: Compressing objects: 100$ (7/7), done. 

remote: Total 20 (delta 3), reused 20 (delta 3) 
Receiving objects: 100$ (20/20), done. 

Resolving deltas: 100% (3/3), done. 

$ cd git-tutorial 


执行 git _ clone 命令 后 我 们 会 默认 处 于 master 分 支 下 ， 同 时 系统 
会 自动 将 origin 设置 成 该 远程 仓库 的 标识 符 。 也 就 是 说 ， 当 前 本 地 仓库 
的 master 分 支 与 GitHub 端 远程 仓库 (origin ) 的 master 分 文 在 内 容 上 是 
完全 相同 的 。 


$ git branch -a 





* master 
remotes/origin/HEAD -» origin/master 
remotes/origin/feature-D 


remotes/origin/master 


我 们 用 git branch -a 命令 查看 当前 分 支 的 相关 信息 。 添 加 -a 
参数 可 以 同时 显示 本 地 仓库 和 远程 仓库 的 分 支 信 息 。 

结果 中 显示 了 remotes/origin/feature-D， 证 明 我 们 的 远程 仓库 中 已 经 
^H f feature-D 分 支 。 



































@…… 获取 远程 的 feature-D 分 支 
我 们 试 着 将 feature-D 分 支 获取 至 本 地 仓库 。 


$ git checkout -b feature-D origin/feature-D 





Branch feature-D set up to track remote branch feature-D from origin. 
Switched to a new branch 'feature-D' 


- b 参数 的 后 面 是 本 地 仓库 中 新 建 分 支 的 名 称 。 为 了 便于 理解 ， 我 
们 仍 将 其 命名 为 feature-D， 让 它 与 远程 仓库 的 对 应 分 支 保 持 同 名 。 新 建 
分 支 名 称 后 面 是 获取 来 源 的 分 支 名 称 。 例 子 中 指定 了 origin/feature-D， 
就 是 说 以 名 为 origin 的 仓库 ( 这 里 指 GitHub 端的 仓库 ) 的 feature-D 分 
支 为 来 源 ， 在 本 地 仓库 中 创建 feature-D 27 3x 
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e 向 本 地 的 feature-D 分 支 提交 更 改 


现在 假定 我 们 是 另 一 名 开发 者 ， 要 做 一 个 新 的 提交 。 在 README. 
md 文件 中 添加 一 行文 字 ， 查 看 更 改 。 


$ git diti 
diff --git a/README.md b/README.md 
index af647fd..30378c9 100644 
--- a/README.md 
+++ b/README.md 
@@ -3,3 «3,4 @@ 
- feature-A 
- fix-B 





= feature-C 


+ = feature-D 


按照 之 前 学 过 的 方式 提交 即 可 。 


$ git commit -am "Add feature-D" 
[feature-D ed9721e] Add feature-D 


1 file changed, 1 insertion(-) 





e 推送 feature-D 分 支 
现在 来 推送 feature-D 分 支 。 


$ git push 
Counting objects: 5, done. 
Delta compression using up to 8 threads. 
Compressing objects: 100$ (2/2), done. 
Writing objects: 100% (3/3), 281 bytes, done. 
Total 3 (delta 1), reused 0 (delta 0) 
To gitGgithub.com:github-book/git-tutorial.git 

cagto8b. ed9T21le featuresD -> FeaturesD 

e 


从 远程 仓库 获取 feature- ud ecco 再 将 
feature-D 分 支 推送 回 远程 仓库 ， 一 系列 操作 ， 就 可 以 与 其 他 开发 
者 相互 合作 ， 共 同 培育 feature-D 实现 某 些 功能 。 


AL 





T 








@ git pull 一 一 获取 最 新 的 远程 仓库 分 支 


现在 我 们 放下 刚刚 操作 的 目录 ， 回 到 原先 的 那个 目录 下 。 这 边 的 本 
地 仓库 中 只 创建 了 feature-D 分 文 ， 并 没有 在 feature-D 分 文中 进行 任何 
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提交 。 然 而 远程 仓库 的 feature-D 分 支 中 已 经 有 了 我 们 刚刚 推送 的 提交 。 
这 时 我 们 就 可 以 使 用 git pull 命令， 将 本 地 的 feature-D 分 支 更 新 到 最 新 
状态 。 当 前 分 支 为 feature-D Xo 


$ git pull origin feature-D 





remote: Counting objects: 5, done. 

remote: Compressing objects: 100$ (1/1), done. 

remote: Total 3 (delta 1), reused 3 (delta 1) 

Unpacking objects: 100% (3/3), done. 

From github.com:github-book/git-tutorial 
* branch feature-D -> FETCH HEAD 
First, rewinding head to replay your work on top of it... 
Fast-forwarded feature-D to ed9721e686f£8c588e55ec6b8071b669f411486b8. 


GitHub 端 远程 仓库 中 的 feature-D 分 支 是 最 新 状态 ， 所 以 本 地 仓库 
中 的 feature-D 分 支 就 得 到 了 更 新 。 今 后 只 需要 像 平 常 一 样 在 本 地 进行 提 
交 再 push 给 远程 仓库 ， 就 可 以 与 其 他 开发 者 同时 在 同一 个 分 支 中 进行 
作业 ， 不 断 给 feature-D 增加 新 功能 。 

如 果 两 人 同时 修改 了 同一 部 分 的 源 代码 ，push 时 就 很 容易 发 生 冲 
突 。 所 以 多 名 开发 者 在 同一 个 分 支 中 进行 作业 时 ， 为 减少 冲突 情况 的 发 
生 ， 建 议 更 频繁 地 进行 push 和 pull 操作 。 
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至 此 为 止 , 阅读 并 理解 本 书 所 必需 的 Git 操作 已 经 全 部 讲解 完了 。 
但 是 在 实际 的 开发 现场 ， 往 往 要 用 到 更 加 高 级 的 Git 操作 。 这 里 ,我 们 
向 各 位 介绍 一 些 参 考 资 料 ， 能 够 帮助 各 位 深入 理解 Git 的 相关 知识 。 

















@ Pro Git 


Pro Gif 由 就 职 于 GitHub 公司 的 Scott Chacon? 执笔 , 是 一 部 零 基础 
的 Git 学 习 资 料 。 基 于 知识 共享 的 CC BY-NC-SA 3.0 许可 协议 ， 各 位 可 




















(D http://git-sem.com/book/zh/v1 
@ https;//github.com/schacon 
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以 免费 阅读 到 包括 简体 中 文 在 内 的 各 国语 言 版 本 。 


€ LearnGitBranching 


LearnGitBranching " 是 学 习 Git 基本 操作 的 网 站 ( 图 4.9 )。 注 重 树 形 
结构 的 学 习 方 式 非常 适合 初学 者 使 用 ， 点 击 右 下 角 的 地 球 标志 还 可 切换 
各 种 语言 进行 学 习 。 


图 4.9 “LearnGitBranching ( 简体 中 文 版 ) 


KG 


区 
g 





e tryGit 


通过 tryGits 我 们 可 以 在 Web 上 一 边 操作 一 边 学 习 Git 的 基本 功能 
(图 4.10 )。 很 可 惜 该 教程 具有 英文 版 。 





(D http://pcottle.github.io/learnGitBranching/ 
Q) http;//try.github.io/ 
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图 4.10  tyGit 





© 名 


1.2 - Checking the Status 


Good job! As Git just told us, our octobox directory now has an empty repository in /.git/. t G it 
The repository is a hidden directory where Git operates. ry 


To save your progress as you go through this tutorial -- and earn a badge when you 
successfully complete it -- head over to create a free Code School account. We'll wait for 
you here. 


Next up, let's type the git status command to see what the current state of our project is: 





git status 
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本 章 就 理解 本 书 所 必需 的 Git 操作 进行 了 讲解 。 只 要 掌握 了 本 章 的 
知识 ， 就 足以 应 付 日 常 开 发 中 的 大 部 分 操作 了 。 

遇 到 不 常用 的 特殊 操作 时 ， 还 请 各 位 读者 查阅 本 书 介绍 的 参考 资 
料 ， 确 保 操 作 的 正确 性 。 
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GitHub 为 实现 社会 化 编程 提供 了 诸多 功能 。 本 章 就 请 各 位 读者 随 我 
们 一 起 边 看 页 面 边 学 习 ， 加 深 对 GitHub 丰富 功能 的 理解 。 





5.1 键盘 快捷 键 


在 GitHub 中 ， 很 多 页 面 都 可 以 使 用 键盘 快捷 键 。 熟 悉 键盘 操作 ， 
能 够 让 GitHub 变 得 更 加 便捷 

在 各 个 页 面 按 下 shift + /都 可 以 打开 键盘 快捷 键 一 览 表 (图 5.1), 
查看 当前 页 面 的 快捷 键 。 如 果 想 要 感受 更 加 快捷 的 操作 ， 不 妨 亲 自 试 
一 试 。 


5.1 按 下 shift + / 显示 快捷 键 一 览 





o 











Keyboard shortcuts (Show all) 


Site wide shortcuts 

Bl Focus command var, search ait 
repositories 

D] Focus command bar, search the. 
current repository 


BB Go Nowrcatons 
Bring up this help dialog 
Move selection down 


Move selection up 
Toggle selection 
B EA Open selection 


Repositories 
Øg «o 
ØB &v issues 
na Go to Pull Requests 
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52 工具 栏 


e 关于 UI 
工具 栏 常 驻 于 各 个 页 面 的 上 端 ， 让 我 们 先 来 讲解 它 的 相关 知识 
图 5.2 )。 

















图 5.2 ”工具 栏 

o . This repository ~ Search or type a commanc © Explore Gist Blog Help 怕 nrocaster +- x P 
HH H nua H 回 四 四 
e 1] LOGO 


点 击 GitHub ff) LOGO 就 会 进入 控制 面板 。 控 制 面板 的 相关 知识 将 
在 后 面 讲解 。 





e 四 Notifications 








这 一 图 标 用 于 提示 用 户 是 否 有 新 的 通知 。 当 图 标 为 蓝 色 时 表示 有 未 
读 通 知 。 用 户 在 新 建 sue 、 被 评论 、 进 行 Pull Request 等 时 都 会 收 到 通 
知 。 另 外 ， 按 照 默 认 设置 ， 用 户 在 GitHub 收 到 的 通知 会 同时 发 送 到 该 
] 户 的 注册 邮箱 。 邮 箱 接收 通知 的 相关 设置 在 Account settings 中 进行 ”。 






























































e— 加 搜索 窗口 
在 这 里 输入 想 找 的 用 户 或 代码 片段 ， 就 可 以 搜索 到 与 之 相关 的 





e 四 Explore 
从 各 个 角度 介绍 GitHub 上 的 热门 软件 。 





(D https://github.com/settings/notifications 
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e GitHub 公司 特别 介绍 的 软件 ( 附 开发 者 制作 的 视频 ) 
。 按 语言 筛选 本 日 / 周 /月 的 热门 仓库 /开发 者 " 








在 这 里 有 机 会 了 解 到 最 尖端 的 技术 和 软件 。 作 为 一 名 程序 员 ， 可 以 
在 上 面 找到 许多 灵感 。 建 议 各 位 定期 关注 一 下 这 里 。 笔 者 也 经 常 借助 语 
言 筛选 器 查询 各 语言 的 顶尖 代码 库 。 























Gist 功能 主要 用 于 管理 及 发 布 一些 没 必要 保存 在 仓库 中 的 代码 ， 比 
如 小 的 代码 片段 等 。 笔 者 就 经 常 把 一 些 随便 编写 的 脚本 代码 等 放 在 Gist 
中 。 系 统 会 自动 管理 更 新 历史 ， 并 且 提 供 了 Fork 功能 。 男 外 ， 通 过 Gist 
还 可 以 很 方便 地 为 同事 编写 代码 示例 。 

在 Gist 上 添加 的 代码 示例 可 以 舱 入 博客 中 。 当 然 ， 如 果 选 择 了 语 
言 ， 还 会 自动 添加 语法 高 亮 。 详 细 介绍 请 参考 附录 B. 

















这 是 到 GitHub 公司 官方 博客 的 超 链接 ，GitHub 公司 会 在 上 面 发 布 
通知 。 新 功能 的 通知 、 新 人 职员 工 的 介绍 、drinkup 聚会 的 信息 等 都 会 
在 上 面 定 期 发 布 。 
































GitHub 相关 的 帮助 。 昌 然 只 有 英文 版 , 但 用 的 都 是 比较 简单 的 英 
文 ， 册 到 不 懂 的 地 方 不 妨 在 这 里 查 一 下 。 





e— B3. HAE 

点 击 后 会 显示 用 户 的 个 人 信息 页 面 。 个 人 信息 页 面 将 在 后 面 进行 
e El Create a new... 

创建 新 的 Git 仓库 或 Organization， 向 Organization 添加 成 员 、 小 
























































(D https://github.com/trending 
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5.3 ”控制 面板 

















组 、 仓 库 ， 为 仓库 添加 Issue 或 collaborator 等 操作 的 菜单 都 聚集 在 这 
里 。 显 示 内 容 会 根据 当前 页 面 不 同 而 改变 。 











e 四 Account settings 

Account settings 的 图 标 是 一 把 螺丝 刀 和 一 柄 锤子 ， 点 击 它 可 以 打开 
账户 设置 页 面 。 在 这 里 可 以 进行 个 人 信息 、 安 全 管理 、 付 费 方案 的 设 
置 ， 各 位 在 使 用 GitHub 时 请 务必 浏览 一 遍 。 

















e--—- ffl Sign out 


点 击 这 个 按钮 可 以 退出 GitHub。 


5.3 ”控制 面板 


e XT UI 
现在 为 各 位 讲解 登录 GitHub 时 最 先 显 示 在 我 们 眼前 的 控制 面板 
CE] 5.3 )。 
图 5.3 “控制 面板 





o -* Exploro Gist Blog Holp Bywa +- X E 
Nove - 
Qu 09 PE 
closed issue ralis/ralls 13887 
Bm 
coi ited on is ils/rails#1388; 
ee tot ropiase tho bind aro tho databas ^ 





opened issue ralls/ralls 413887 
Vy. ArelAR not replacing binds corect? 


commented on pull request ralls/ralls#13886 
select(ititle) ? 
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em Q News Feed 











显示 当前 已 Follow 的 用 户 和 已 Watch 的 项 目的 活动 信息 ， 用 户 可 
以 在 这 里 查看 最 新 动向 。 将 右上 角 RSS 标志 的 URL 添加 到 RSS 阅读 器 
中 ， 还 可 以 通过 RSS UE. 











@…… 思 Pull Requests 








显示 用 户 已 进行 过 的 Pull Request。 通 过 这 里 ， 开 发 者 可 以 很 方便 地 
追踪 Pull Request 的 后 续 情 况 。 














@…… O Issues 








在 这 里 可 以 查看 用 户 拥有 权限 的 仓库 或 分 配给 自己 的 sue。 当 用 户 
同时 进行 多 个 项 目 时 ， 可 以 在 这 里 一 并 查看 Issue, 











e © Stars 




















以 列表 的 形式 显示 用 户 添加 了 Star 的 仓库 。 有 些 仓库 需要 经 常 查 
R, 但 又 不 必 在 Watch 中 频繁 显示 详细 信息 时 ， 可 以 给 这 些 仓库 添加 
Star, 方便 自己 随时 在 这 一 栏 中 找到 它们 。 























e O Broadcast 























主要 用 于 接收 GitHub 公司 发 来 的 通知 或 使 用 技巧 的 小 贴 士 。 














e Q Repositories you contribute to 

















显示 用 户 做 过 贡献 的 仓库 。 按 贡献 时 间 的 先后 顺序 排列 。 











e @ Your Repositories 








按 更 新 时 间 顺 序 显示 用 户 的 仓库 。 标 有 钥匙 图 案 的 是 非 公 开 仓 库 ， 
标 有 类 似 字母 Y 图 案 的 是 用 户 Fork 过 的 仓库 。 





图 灵 社 区 会 员 lxghost2 专 享 尊重 版 权 





54 个 人 信息 


访问 下 述 URL， 就 可 


https://github.com/ 


e 关于 UI 


我 们 以 Chris Wanstrath 的 个 人 信息 页 ( 


图 5.4 “个 人 信息 
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以 看 到 各 位 的 个 人 信息 。 

















EZ 








图 5.4 ) 为 例 进行 讲解 。 

















E Contributions LI Repositories A Public Activity 
A Popular repositories EH Repositories contributed to 
E] Jquery-pjax E] leyink/getwelltermie 
R 57 * z , o 
pushState + ajax = pjax Get well card for Termie, internet style. 
E] facebox A * E] jch/html-pipeline Tui 
Facebook-style lightbox, built in jQuery : HTML processing filters and utilities =. 
E] mustache 12080 E] github/email reply parser 28 请 
Logic-less Ruby templates. Unmaintained. - Small library to parse plain text email co... e 
E Chris Wanstrath EJ dotjs une El github/hub TN 
defunkt "is hub helps you win at git s 
B gist 1,76 * E] new-user/new-repo D* 
Potentially the best command line gister. 
GitHub 17:3 
San Francisco 
chrisGgithub.com 四 Pubic contributions 
htip://chriswanstrath.com/ 
Joined on Oct 19, 2007 
" 
12k 563 208 四 
e f " 
Learn more. zm 
Organizations 27 Total 2 days 0 days 
图 一 
Year of Contributions Longest Streak Current Streak 
H Contribution Activity od: 1 Week ~ 


a 


他 Untolow {~ 


defunkt has no activity during this period. 








E 用 户 信息 


这 里 显示 注册 用 户 的 基本 信息 ， 








包括 姓名 、 所 属 公司 、 邮 箱 地 址 、 








已 加 入 的 Organization 等 。 如 果 对 该 用 户 感 兴趣 ， 可 以 点 击 页 面 右上 角 
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的 Follow 按钮 (已 经 Follow 的 用 户 会 显示 Unfollow )。 这 样 一 来 ， 这 个 
人 在 GitHub 上 的 活动 都 会 显示 在 您 的 News Feed 中 。 














e H Popular Repositories 














显示 公开 仓库 中 受 欢 迎 的 、 拥 有 大 量 Star 的 部 分 热门 仓库 。 

















e El Repositories contributed to 








按时 间 的 先后 顺序 显示 该 用 户 做 过 贡献 的 部 分 仓库 。 该 用 户 可 能 是 
这 个 仓库 的 软件 开发 者 ， 也 可 能 只 是 通过 发 送 Pull Request 等 方式 对 该 
仓库 做 过 某 些 贡 南 



































e 











o 


e E Public contributions 





一 格 表示 一 天 ， 记 录 当 日 用 户 对 拥有 读 取 权限 的 仓库 的 大 致 贡献 
度 。 贡 献 度 的 衡量 标准 包括 发 送 Pull Request 的 次 数 、 写 Issue 的 次 数 、 
进行 提交 的 次 数 等 。 颜 色 越 深 代表 贡献 度 越 高 。 一 名 程序 员 绿 色 的 天 数 
越 多 ,证 明 他 对 GitHub 越 熟悉 。 








e Ei Contribution Activity 











按时 间 顺 序 显 示 具 体 贡 献 活动 的 链接 。 














e [1 Repositories 


显示 该 用 户 公开 的 仓库 ( 图 5.5 ).. Fork 来 的 仓库 也 显示 在 这 里 。 
仓库 名 称 、 简 要 说 明 、 使 用 的 语言 、 最 终 更 新 日 期 都 会 出 现在 列表 
中 。 星 形 图 案 旁 边 的 数字 表示 给 这 个 仓库 添加 Star 的 人 数 ， 再 旁边 是 被 
Fork 数 。 

背景 显示 的 图 标 表示 这 个 仓库 的 更 新 频率 。 横 向 为 时 间 轴 ， 右 侧 为 
最 新 时 间 。 表 中 色 块 越 高 ， 该 仓库 的 更 新 频率 也 就 越 高 。 
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图 5.5 Repositories 标签 页 





E Contributions E Repositories & Public Activity Sr Untolow | $~ 
Find a repository. Search All Sources Forks Mirrors 
E] jquery-pjax JavaScript $8,256 Dads 


pushState + ajax = pjax 
Last updated 9 hours ago 





Chris Wanstrath A unicorn Ruby s D159 


mirrored from git//git.bogomips.org/unicorn git 
defunkt LS : 

Unofficial Unicorn Mirror. 

Last updated 19 hours ago 


GitHub 
San Francisco - 
chrisGgithub.com 加 rails Ruby **2 P7274 
http://chriswanstrath.com/ Jorod Yom rellelaita 
Ruby on Rails 


Joined on Oct 19, 2007 
Last updated 2 days ago 


12k 563 208 


folowers starred following EE coffee-mode EmacsLisp k447 135 











e Public Activity 


显示 该 用 户 的 公开 活动 (图 5.6 )。 活 动 就 是 指 这 个 用 户 做 了 什么 
比如 向 仓库 进行 提交 或 者 Pull Request 等 ， 其 大 量 的 公开 信息 都 会 记录 
在 这 里 。 
ee dtd ere GitHub 上 做 些 什 么 。 比 如 查看 
崇拜 已 久 的 程序 员 的 公开 活动 ， 就 可 以 知道 他 现在 关注 些 什么 , 或 
we 


图 5.6 Public Activity 标签 页 











E] Contributions ^ KJRepositories ^ à Public Activity 人 Untollow 将- 


43 defunkt commented on issue defunkt/|query-pjax4344 
Done. Do we know anyone at GitHub we can bribe to get non-owner admin permissions implemented? 


GG defunkt closed issue defunkt/Jquery-pjax#344 


m Add Gmislav as collab 





Chris Wanstrath defunkt added mislav to defunkt/jquery-pjax 
defunkt 
? — defunkt created tag v4.8.1 at defunkt/unicorn 20 hour: 
GitHub 
V^ — defunkt forked rails/rails to defunkt/rails 2 days ago 
San Francisco 
chrisGgithub.com 


http://chriswanstrath.com/ b defunkt created branch llerrloop at defunkt/unicom 2 d 


Joined on Oct 19, 2007 








defunkt created tag v4.8.0 at defunkt/unicom 19 days ago 
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55 仓库 


仓库 的 URL 形式 如 下 所 示 。 

















https://github .com/ 用 户 名 /仓库 名 











这 个 页 面 可 以 说 是 各 个 软件 的 大 门 。 循 着 目录 找 下 去 我 们 就 可 以 查 
阅 自己 想 要 的 文件 。 如 果 有 相应 权限 ， 还 可 以 对 文件 的 内 容 直 接 进 行 纺 


18 ` 提交 。 


























e 关于 UI 


我 们 以 图 5.7 为 例 进 行 说 明 。 特 别 重要 的 项 目 会 在 本 章 后 半 部 分 重 
新 详细 讲解 。 

















oO 用 户 名 ( 组 织 名 ) / 仓库 名 


左上 角 图 标 旁 边 显示 的 是 用 户 名 和 仓库 名 。 和 斜 线 左 侧 为 用 户 名 。 使 
用 GitHub 的 组 织 账 户 时 ， 这 一 部 分 则 为 组 织 名 。 斜 线 右 侧 是 仓库 名 。 




















e @ Watch/Star/Fork 


眼睛 图 标 旁 边 写 着 Watch 字样 。 点 击 这 个 按钮 就 可 以 Watch 该 仓库 ， 
今后 该 仓库 的 更 新 信息 会 显示 在 用 户 的 公开 活动 中 。Star 旁边 的 数字 表示 
给 这 个 仓库 添加 Star 的 人 数 。 这 个 数 越 高 ， 代 表 该 仓库 越 受 关注 。 

Watch 与 Star 有 所 不 同 ，Watch 之 后 该 仓库 的 相关 信息 会 在 后 述 的 
Notifications 中 显示 ， 让 用 户 可 以 追踪 仓库 的 内 容 ， 而 Star 更 像 是 书签 ， 
让 用 户 将 来 可 以 在 Star 标 记 的 列表 中 找到 该 仓库 。 另 外 ，Star 数 还 是 
GitHub 上 判断 仓库 热门 程度 的 指标 之 一 。 

旁边 的 分 又 图 标 是 Fork 按钮 。 后 面 的 数字 代表 该 仓库 被 Fork 至 各 
用 户 仓 库 的 次 数 。 这 个 数字 越 大 ， 表 示 参 与 这 个 仓库 开发 的 人 越 多 。 
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E57 CERE 


O * This repository Explore Gist Blog Help E hirocaster +- X P 





hirocaster / wdpress69 © o Gi Watch ~ 119 W Star 124 [f Fork 285 


WEB+DB PRESS Voll.69 详解 GitHub http//hirocaster.github.com/wdpress69/ 








o9 9^ Code 
O w O: Q ， O x» 
uuu rM) 
© P branch: gh-pages ~ wdpress69 / (y Qnin 
Merge pull request 4315 from noglog/work «= o Wiki 
MI est commit d89953ef4d (2. 
© ncs WEZ MENT, + Pus 
an pts Created gh-pages branch via GitHub 2 years ago o Grap 
A info 0 ago © — 
Ad o Ds 
d EXE SS 
Q: 


e README.md 





WEB-*DB PRESS Vol.69 详解 GitHub D Ese ne 


(13) 4p» Download ZIP 
为 本 特辑 专门 设立 的 网 站 
http://hirocaster.github.com/wdpress69/ 
写 给 需要 合并 Pull Requst 的 人 


解决 Git 冲突 问题 的 步骤 




















显示 该 仓库 中 的 文件 列表 。 仓 库 名 下 方 是 该 仓库 的 简单 说 明和 

















e o Issue 











JF BUG 报告 、 功 能 添加 、 方 向 性 讨论 等 ， 将 这 些 以 Issue 形式 进 
行 管理 。Pull Request 时 也 会 创建 Issue。 劳 边 显 示 的 数字 是 当前 处 于 
Open 状态 的 Issue 数 。 











e © Pull Requests 

















在 Pull Requests 中 可 以 列表 查看 并 管理 Pull Request。 代 码 的 更 改 和 
讨论 都 可 以 在 这 里 进行 。 旁 边 显 示 的 数字 表示 尚未 Close 的 Pull Request 
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Wiki 是 一 种 比 HTML 语法 更 简单 的 页 面 描述 功能 。 常 用 于 记录 开 
发 者 之 间 应 该 共享 的 信息 或 软件 文档 。 数 字 表 示 当 前 Wiki 的 页 面 数量 。 























i @ Pulse 


显示 该 仓库 最 近 的 活动 信息 。 该 仓库 中 的 软件 是 无 人 问津 ， 还 是 在 
火热 地 开发 之 中 ， 从 这 里 可 以 一 目 了 然 。 








e © Graphs 








以 图 表 形 式 显 示 该 仓库 的 各 项 指标 。 让 用 户 轻 松 了 解 该 仓库 的 活动 











eo O Network 


以 图 表 形 式 直观 地 显示 出 当前 仓库 的 状态 及 Fork 出 的 仓库 的 状态 。 
同时 会 显示 成 员 列 表 。 











e@……@ Settings 








这 里 可 以 更 改 当 前 仓库 的 设置 。 用 户 必须 拥有 更 改 设 置 的 权限 才能 
看 到 这 个 菜单 。 











e @ SSH clone URL 


clone 仓库 时 所 需 的 URL。 点 击 右 侧 的 剪贴 板 图 标 可 以 将 URL 复制 
到 剪贴 板 中 。 点 击 HTTPS、SSH、Subversion 图 标 可 以 切换 至 相应 协议 
的 URL。 














e (p Clone in Desktop 




















启动 GitHub 专用 的 客户 端 应 用 程序 并 进行 clone, GitHub 专用 的 客 
户 端 应 用 程序 有 Windows 版 和 Mac 版， 详细 情况 请 参考 附录 A 的 讲解 。 
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e ® Download ZIP 





将 当前 正在 阅览 的 分 支 中 的 文件 以 ZIP 形式 打包 下 载 。 这 种 方式 与 
Git 的 clone 不 同 ， 只 是 单纯 将 文件 下 载 到 本 地 ， 所 以 无 法 通过 Git 查看 
日 志 或 对 仓库 进行 更 改 。 如 果 只 是 想 使 用 仓库 中 的 文件 ， 比 较 适 合用 这 
种 方式 下 载 。 


























e-------- © commits 
在 这 里 可 以 查看 当前 分 支 的 提交 历史 。 左 侧 的 数字 表示 提交 数 。 
@…… © branches 
可 以 查看 仓库 的 分 支 列表 。 左 侧 的 数字 表示 当前 拥有 的 分 支 数 。 


e Q releases 








显示 仓库 的 标签 (Tag) 列表 。 同 时 可 以 将 标签 加 入 时 的 文件 以 归 
档 形式 (ZIP 、targz ) 下 载 到 本 地 。 软 件 在 版 本 升级 时 一 般 都 会 打 标 签 ， 
如 果 需 要 特定 版 本 的 文件 ， 可 以 从 这 里 寻找 。 


























e O contributors 











显示 对 该 仓库 进行 过 提交 的 程序 员 名 单 。 如 果 您 也 对 该 仓库 发 送 过 
Pull Request 并 且 被 采纳 ， 那 么 在 这 里 就 能 找到 自己 的 名 字 。 左 边 的 数字 
是 程序 员 的 人 数 。 




















ee Q Compare & review 








可 以 查看 当前 显示 的 分 支 与 其 他 分 支 的 差别 ， 以 便 进行 审查 。 点 击 
这 个 按钮 ， 会 出 现 一 个 页 面 让 用 户 选择 比较 对 象 。 

















人 Q branch 


显示 当前 分 支 的 名 称 。 从 这 里 可 以 切换 仓库 内 分 支 ， 查 看 其 他 分 支 
的 文件 。 
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显示 当前 文件 列表 的 路 径 。 点 击 上 级 目录 的 链接 就 可 以 直接 移动 至 
该 目录 。 











e Q Fork this project and Create a new file 


可 以 在 当前 仓库 的 路 径 下 新 建文 件 。 新 建文 件 作 为 一 个 新 的 提交 ， 
记录 在 Fork 出 的 分 支 中 。 

如 果 用 户 对 该 仓库 拥有 足够 权限 ， 该 项 则 显示 为 Create a new file, 
用 户 可 以 直接 在 当前 路 径 下 新 建文 件 。 












































@……@fiiles 


可 以 查看 当前 分 支 的 文件 。 顶 端 为 最 新 提交 的 相关 信息 。 在 文件 或 
目录 的 列表 中 ， 从 左 至 右 分 别 为 文件 名 称 、 该 文件 最 新 的 提交 日 志 、 更 
新 日 期 。 点 击 目录 或 文件 就 可 以 查看 相应 内 容 。 

如 果 当 前 目录 中 包含 README 文件 ,那么 在 文件 列表 下 方 会 显示 
README., 一 般 而 言 ， README 中 记录 着 该 仓库 中 软件 的 说 明 或 使 用 
方法 以 及 许可 协议 等 信息 ， 请 务必 加 以 阅读 。 

















e 文件 的 相关 操作 


点 开 文件 后 会 显示 出 文件 的 内 容 ， 同 时 右上 角 会 显示 用 于 该 文件 的 
菜单 (图 5.8), Edit 可 以 对 文件 内 容 进行 编辑 并 提交 。Raw 可 以 直接 在 
浏览 器 中 显示 该 文件 的 内 容 。 使 用 这 个 URL， 就 能 通过 HTTPS 协议 获 
取 该 文件 。Blame 能 够 按 行 显示 最 新 提交 的 信息 。History 可 以 查看 该 文 
件 的 历史 记录 。Delete 可 以 删除 这 个 文件 。 


5.8 “文件 相关 操作 的 菜单 



































[a4 Open Edit Raw Blame History Delete 











文件 内 容 的 左 侧 会 显示 该 文件 的 行 号 。 假 如 我 们 点 击 第 10 行 的 行 
号 ， 这 一 行 就 会 被 高 之 标记 为 黄色 ， 同 时 URL 末尾 会 自动 添加 
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“#L10”。 使 用 这 个 URL， 程 序 员 们 在 交流 时 ， 就 可 以 将 讨论 明确 指向 
某 一 行 。 另 外 ， 如 果 将 “ 才 10” 改 成 “ 帮 10-15”， 则 会 标记 该 文件 的 第 
10 一 15 行 。 各 位 不 妨 将 这 点 记 下 来 ， 以 便 日 后 应 用 。 


















































专栏 : 通过 部 分 名 称 搜 索 文件 

各 位 不 妨 在 仓库 页 面试 着 按 下 键盘 的 { 键 ， 然 后 输入 要 找 的 
目录 或 文件 的 部 分 名 称 。 和 筛选 器 会 在 仓库 的 目录 和 文件 中 进行 篇 
选 ， 搜 索 出 您 要 找 的 文件 ( 图 a )。 
这 种 方式 要 比 一 级 级 查看 目录 和 文件 快 得 多 ， 请 积极 利用 。 
图 a 搜索 yml 


bootstrap / yml 












































































































































Youve activated the file finder by pressing | t Start typing to filter the file list. Use + and| 1 to navigate, enter | to view files. x 


[B .travis.yml 
国 docs/examples/sticky-footer.html 


国 docs/examples/sticky-footer.navbar.himl 














在 GitHub 上， 直接 修改 URL 就 可 以 让 用 户 以 多 种 形式 查看 差别 。 
这 里 我 们 以 Ruby on Rails 的 仓库 ”为 例 , 给 各 位 介绍 直接 修改 URL 的 一 
些 技巧 。 




















@…… 查看 分 支 间 的 差别 


比如 我 们 想 查 看 4-0-stable 分 支 与 3-2-stable 分 支 之 间 的 差别 ， 可 以 
像 下 面 这 样 将 分 支 名 加 到 URL. 里 。 


https://github.com/rails/rails/compare/4-0-stable...3-2-stable 








这 样 ， A nd (图 5.9)。 可 以 看 到 ， 有 65 
名 程序 员 经 过 1710 次 提交 ， 完 成 了 3.2 版 本 到 4.0 版 本 的 升级 工作 。 








(D  https://github.com/rails/rails/ 
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图 5.9 3-0-stable 与 4-0-stable 的 差别 











o e This repository ~ Search or type a command © Explore Gist Blog Help E hirocaster +- X P 
E] rails / rails G5 Watch ~ 1366 X Unstar 2064 [f Fork 7276 
Wm B40-stable … 1/3-2-stable Edit o 
Please review the guidelines tor contributing to this repository. © 
S EEE o 
^ 
1,710 commits 679 files changed 23 comments 65 contributors " 
Commits ^ Files Changed Commit Comments p 


This comparison is big! We're only showing the most recent 250 commits 


Mar 03, 2013 


D ax Merge pull request #9528 from korny/patch-l == 





Bom Merge pull request $9531 from erik-escobedo/patch-1 = 


Mar 04, 2013 

Wama Fix issue $7526. Reload the target if it's stale. = 939b896 
Mar 05, 2013 

下 一 一 一 Backport fixes about #7774 to 3-2-stable = dof22a9 
| c Merge pull request #9543 from maximerety/backport fix 7774 = Gdf9647 
B -—--— Freeze columns only once per Result = b544524 
B--—-- Update CHANGELOGs for 3.2.13.rcl Slae6f4 
ÉL: Revert "Merge pull request #8209 from senny/backport 8176" = X 1b699fc 
Mar 06, 2013 

Rmus bumping to rc2 ccf256d 
Mar 07, 2013 

Ho Use shorter prefix and suffix as in Oracle database identifier = 5d57b82 
(eras merge pull request 49594 from yahonda/3-2-stable prefix suffix = bb0007f 
js — Merge pull request #9549 from larrylv/reload-stable-target-before-saving = X 9bdSc86 
Š- Etarget might be nil when Identity Map is enabled. = 





dicem ma Merge pull request 49600 from larrylv/fix-load-target-with-identity-m. = 








@…… 查看 与 几 天 前 的 差别 


假如 我 们 想 查 看 master 分 支 在 最 近 7 天 内 的 差别 ， 可 以 像 下 面 这 样 
这 样 将 时 间 加 入 URL。 


https://github.com/rails/rails/compare/master@{7.day.ago}...master 


这 样 ， 就 可 以 查看 这 段 期 间 内 的 差别 。 
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* day 
* week 
* month 


e year 











指定 期 间 可 以 使 用 以 上 四 个 时 间 单 位 。 如 果 差 别 过 大 则 不 会 列 出 所 
有 提交 ， 只 显示 最 近 的 一 部 分 。 














e- 查看 与 指定 日 期 之 间 的 差别 


假设 我 们 想 查 看 master 分 支 2013 年 1 月 1 日 与 现在 的 区 别 ， 可 以 
将 日 期 加 入 URL. 





https://github.com/rails/rails/compare/master@{2013-01-01}...master 


这 样 ， 便 可 以 查看 与 指定 日 期 之 间 的 差别 。 但 是 如 果 指 定 日 期 与 现 
在 的 差别 过 大 ,或 者 指定 日 期 过 于 久远 ， 则 无 法 显示 。 
由 于 可 以 从 多 种 角度 查看 差别 ， 所 以 GitHub 也 称 得 上 是 一 个 优秀 
的 源 代码 查看 器 。 各 位 不 妨 记 住 直接 修改 URL 来 查看 差别 的 方法 ， 当 
遇 到 上 述 倩 况 时 ， 它 能 帮 您 节省 不 少时 间 。 























5.6 lssue 








在 软件 开发 过 程 中 ， 开 发 者 们 为 了 跟踪 BUG 及 进行 软件 相关 讨论 ， 
进而 方便 管理 ,创建 了 Issue。 管 理 Issue 的 系统 称 为 BTS ( Bug Tracking 
System, BUG 跟踪 系统 )。 当 今 具 有 代表 性 的 BTS 有 Redmine”、Trac”、 
Bugzilla^ 等 。 

GitHub 也 为 自身 加 入 了 BTS 的 功能 。 在 GitHub 上 ， 可 以 将 它 作为 


















































(D http;//www.redmine.org/ 
Q) http://trac.edgewall.org/ 
®  http://www.bugzilla.org/ 
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软件 开发 者 之 间 的 交流 工具 ， 多 多 加 以 利用 。 遇 到 下 面 几 种 情况 时 ， 各 
位 就 可 以 使 用 这 个 功能 。 





。 发 现 软件 的 BUG 并 报告 
。 有 事 想 向 作者 询问 、 探 讨 
。 事先 列 出 今后 准备 实施 的 任务 














Issue 除 BUG 管理 之 外 还 有 许多 其 他 用 途 。 在 软件 开发 者 的 圈子 
H, $ Issue 用 于 多 种 用 途 的 情况 已 经 司空 见 惯 。 作 为 GitHub 的 功能 
一 ， 想 必 今 后 会 有 更 多 人 自然 而 然 地 用 到 它 。 所 以 借 此 机 会 ， 让 我 们 来 
共同 学 习 Issue 的 一 些 简单 用 法 。 
































e 简洁 且 表 现 力 丰富 的 描述 方法 

GitHub 的 Issue 及 评论 可 以 使 用 GEM" 语法 进行 描述 ， 从 而 获得 丰 
富 的 表现 力 。 比 如 像 图 5.10 中 那样 描述 ， 然 后 点 击 Preview， 就 可 以 看 
到 图 5.11 中 那 种 标记 后 的 效果 。 














5.10 Markdown 语法 示例 


Please review the guideline 


Let's write markdown. 








Write Preview 


# This is an h1 
## This is an h2 








### code 








(D https;//help.github.com/articles/github-flavored-markdown 
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Æ 5.11 Markdown 语法 效果 预览 


Please review the guideline 


Let's write markdown. 





Write Preview 


This is an h1 








Thie ic an h 
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TE SCA AE S1 n] LAS GEM 语法 相关 帮助 的 链接 ( 图 5.12 )。 





图 5.12 ”Markdown 语法 备 忘 表 的 链接 





No milestone d$ 


Comments are parsed wih GitHub Flavored Markdown 


"- 
B, 























e i& 法 高 亮 
假设 我 们 像 下 面 这 样 ， 先 指定 语言 再 描述 代码 。 
“Kuby 


def hello world 
puts 'Hello World!' 
end 





这 样 一 来 , 代码 就 会 如 图 5.13. 所 示 被 添加 语法 高 亮 








(D 将 代码 的 关键 字 变 色 或 改变 字体 ， 从 而 提高 可 读 性 。 
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5.13 “添加 语法 高 亮 后 的 代码 





hirocaster commented 


def hello world 
puts 'Hello World!' 
end 











e 添加 图 片 


添加 图 片 也 十 分 简单 。 只 需 将 图 片 拖 电 到 文本 框 中 便 可 以 粘贴 图 
片 。 选 择 图 5.14 中 的 链接 会 弹出 对 话 框 ， 在 这 里 也 可 以 完成 同样 的 操 
作 。GitHub 的 网 站 上 也 有 相关 内 容 的 详细 讲解 ， 各 位 不 妨 参 考 一 下 "。 


5.14 “添加 图 片 的 链接 























Attach images by dragging & dropping, selecting them, or pasting from the clipboard. 











© 添加 标签 以 便 整 理 


Issue 可 以 通过 添加 标签 ( Label) 来 进行 整理 。 添 加 标签 后 ，Issue 
的 左 侧 就 会 显示 标签 (图 5.15 )。 点 击 页 面 左 侧 的 标签 ， 还 可 以 只 显示 
该 类 标签 的 Issue. 

标签 可 以 自由 创建 。 既 可 以 像 图 5.15 那样 按 语言 和 技术 分 类 ， 也 可 
以 按照 BUG、 任 务 、 备 忘 等 作业 类 型 分 类 。 各 位 可 以 按照 需要 选择 便 
于 整理 的 标签 。 

提 个 小 建议 : 其 实在 Issue ee 
大 可 等 Issue 积攒 到 一 定数 量 ， 只 有 进行 筛选 才能 清晰 把 握 时 再 添加 
标签 。 


























(D https;//help.github.com/articles/issue-attachments 


图 灵 社 区 会 员 lxghost2 GF 尊重 版 权 


5.6 Issue | 91 


图 5.15 添加 了 标签 的 1ssue 





T1 Mirror 1 component (navs) #8431 
Opened by alaa13212 16 hours ago 


j^ fix faulty input-group-btn display in firefox ED #8429 
Opened by rmehta a day ago 


© Document show,shown,hide,hidden tooltip/popover events js #8428 
Opened by cvrebert a day ago 


Ñ Fixed left tooltip positioning ‘js #8427 
Opened by prezjordan a day ago 9t 2 comments 


I1 Replace position() with offset() in scrollspy.js is; #8419 
Opened by hollensteiner 2 days ago 


© "dropdown-menu input-append" is overriden by form-* .input-append class 图 #8418 
Opened by jezozwierzak 2 days ago 


© [3.0 feature request] Put all jQuery plugins under one prototype namespace js #8409 
Opened by gfranko 3 days ago 


Ñ) Carousel buttons that aren't dependent on Glyphicons [css] #8402 
Opened by mauricew 4 days ago 











e 添加 里 程 碑 以 便 管理 


除 标签 外 ， 还 可 以 通过 添加 里 程 碑 来 管理 Issue。 通 过 图 5.16 可 以 
看 出 ,项目 距离 下 一 个 版 本 (3.0.0 版 ) 还 有 6 个 Issue 需 要 实施 ， 整 体 
的 96% 已 经 实施 完毕 并 Close。 从 这 里 的 链接 我 们 可 以 查看 剩余 的 
Issue; 


设置 里 程 碑 ， 就 可 以 用 Issue 来 管理 任务 。 














图 5.16 version 3.0.0 的 里 程 碑 





Browse lssues Milestones 


Open Milestones 1 ] 1 with issues | O withoutissues ~ DueDate Completeness 


147 closed — 6 open Browse issues 一 





Closed Milestones 15 3.0.0 
No due date 96% 
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专栏 : 了 解 贡献 时 的 规则 ! 
在 描述 Issue 时， 常常 会 看 到 图 a 中 这 种 贡献 规范 的 链接 。 
在 该 仓库 的 根 目 录 下 添加 CONTRIBUTING.md 文件 后 该 链接 就 
显示 出 来 =*。 
规范 的 内 容 一 般 包 括 报告 时 |ssue 的 描述 方法 、Pull 
Request 时 的 规则 或 要 求 、 许 可 证 的 相关 信息 等 。 为 了 在 开源 项 
开发 中 能 与 其 他 人 和 谐 相 处 ， 请 务必 在 贡献 之 前 仔细 阅读 这 些 
规范 。 






























































E 











































































































图 a 规范 的 链接 





Please review the guidelines for contributing to this repository. 














i£a https://github.com/blog/1184-contributing-guidelines 


0 Tasklist 语法 


我 们 可 以 使 用 GFM 的 一 项 独 有 功能 , 那 就 是 Tasklist 语法 "。 首 先 试 
着 按 下 面 的 格式 进行 描述 。 
# 本 月 要 做 的 任务 
- L1 完成 图 片 
- [x] 完成 部 署 工具 的 设置 
- [ ] 实现 抽签 功能 

这 样 一 来 ， 这 段 文字 就 会 被 标记 成 复 选 列表 的 样式 (图 $.17 )。 这 
个 复 选 列表 可 以 直接 匀 选 或 者 取消 ， 不 必 打 开 Issue 的 编辑 页 面 重新 编 
辑 ， 十 分 方便 ， 建 议 各 位 记 住 这 个 功能 。 
















































































(D  https;//github.com/blog/1375-task-lists-in-gfm-issues-pulls-comments 
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图 5.17  Tasklist 语法 


本 月 要 做 的 任务 


C) 完成 图 片 
M 完成 部 署 工具 的 设置 
O 实现 抽签 功能 





























e 通过 提交 信息 操作 Issue 


在 GitHub 上 ， 只 要 按照 特定 的 格式 描述 提交 信息 ， 就 可 以 像 一 般 
BTS 带 有 的 功能 那样 对 Issue 进行 操作 。 








@…… 在 相关 Issue 中 显示 提交 


在 Issue 一 览 表 中 我 们 可 以 看 到 ， 每 一 个 Issue 标题 的 下 面 都 分 配 了 
诸如 “#24” 的 编号 。 只 要 在 提交 信息 的 描述 中 加 入 “#4”"， 就 可 以 如 
图 5.18 所 示 ， 在 Issue 中 显示 该 提交 的 相关 信息 ， 使 关联 的 提交 一 目 了 
然 。 这 里 只 需 轻 轻 点 击 一 下 便 可 以 显示 相应 提交 的 具体 内 容 ， 在 代码 审 
查 时 省 去 了 从 大 量 提交 日 志 中 搜索 相应 提交 的 麻烦 ， 非 常 方便 。 


图 5.18 ”提交 信息 



























































[E ^dd feature user add $24 











CH Close Issue 





如 果 一 个 处 于 Open 状态 的 Issue 已 经 处 理 完毕 ， 只 要 在 该 提交 中 以 
下 列 任意 一 种 格式 描述 提交 信息 ， 对 应 的 Issue 就 会 被 Close。 





e fix #24 

e fixes #24 
* fixed #24 
* close #24 
* closes #24 
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* closed #24 
* resolve 724 
* resolves #24 


* resolved #24 


利用 这 个 方法 ， 每 次 提交 并 push 之 后 ， 就 不 必 再 大 费 周章 地 到 
GitHub 的 Issue 中 寻找 相应 Issue 再 手动 Close， 省 去 不 少 麻烦 。 

像 这 样 ， 只 要 按照 特定 的 格式 描述 提交 信息 ，GitHub 就 会 自动 识别 
并 处 理 ， 让 使 用 GitHub 变 得 更 加 轻松 。 目 前 ， 很 多 GitHub 之 外 的 BTS 
也 实现 了 这 一 功能 ， 记 住 它 绝 对 是 有 利 无 次 的 。 




















e 将 特定 的 Issue 转换 为 Pull Request 


fr GitHub 上 上， 如果 给 Issue 添加 源 代码 ， 它 就 会 变 成 我 们 马上 要 讲 
到 的 Pull Request. Issue 5j Pull Request 的 编号 相互 通用 ， 通 过 GitHub 
的 API 可 以 将 特定 的 Issue 转换 为 Pull Request， 能 够 完成 这 一 操作 的 
hub 命令 将 在 本 书 的 8.1 节 中 讲解 。 在 这 里 ， 各 位 只 要 先 记 住 Issue 与 
Pull Request 的 编号 通用 即 可 。 






































5.7 Pull Request 





Pull Request 是 用 户 修改 代码 后 向 对 方 仓 库 发 送 采 纳 请 求 的 功能 ， 也 
是 GitHub 的 核心 功能 (图 5.19 )。 正 因为 有 了 这 个 功能 ， 才 会 让 众多 开 
发 者 轻松 地 加 入 到 开源 开发 的 队伍 中 来 。 

在 Pull Request 页 面 能 够 列表 查看 当前 处 于 Open 状态 的 Pull 
Request。 通 过 点 击 页 面 左 部 和 上 部 的 选项 可 以 进行 筛选 和 重新 排列 。 

在 列表 中 点 击 特定 的 Pull Request 就 会 进入 详细 页 面 (图 5.20 )。 页 
面 上 方 显示 着 这 次 是 从 谁 的 哪个 分 文 向 谁 的 哪个 分 文 发 送 了 Pull 
Request。 下 面 ， 我 们 对 各 个 标签 ( Tag ) 页 进行 讲解 。 
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5.19 Pull Request — 











o > This repository ~ Search or type a command © Explore Gist Blog Help 怕 nirocaster +- X P 
E] twbs / bootstrap Gi Watch ~ 5124  * Star 63753 Jf Fork 22955 
mem Lp NET c Em 
《> 
Yours nN Rename pack.min.css to docs.min.css to match with docs.min.js #12423 
No description provided. © 
5m os ema 10 hours ago aV 1 comment 
BW n| 
I1 Add "showing" event to modal #12421 
ZDroid 4 Allow additional positioning and/or animation which can't be done until element is visible by tri... 5 
dibit 3 omnem 12 hours ago a8 2 comments 
Wlg zi || Refactored and renamed grid mixins $2412 ^ 
colllin 2 1 don't know if this pull request is welcome, but I've refactored and renamed some grid mixins. l... . 
oeelvik 1 P m 2 days ago alii 4 comments y 
axemclion 1 
| fixes 410495 #12388 
alanhamiett 1 fixes 410495 by forcing .navbar-brand height to prevent its inner content from increasing navbar ... 
soundarapandian 1 国 ass ago B 1 comment 
stuartpb 1 
I| Fix #12375: stop using document.body.scrollTop #12377 
francis-liberty 1 Removes document.. body. scro11Top as it's deprecated in the strict mode. Fixes 412375. /cc Gat 
joepjoosten 1 i = ee 5 days ago ai 4 comments. 
mkurz 1 
nm y 门 Make space between .navbar-right and screen when without container. 412368 
magicalhobo Gnavbar-padding-horizontal should only be subtracted from .navbar-right:last-child if it is insid... 
Robadob 1 Ml m5 days 200 4 2 comments 





5.20 Pull Request 的 详细 页 面 








Add output GitHub #1 «Em 


IET. rM yuria merged 3 commits into master from 7-case-output-github 11 months ago 


M Conversation ® © Commits 3 Files Changed 加 


g9 hirocaster commented 11 months ago f Labels 
None yet 


* 含有 数字 7 时 显示 GitHub ^ 








Milestone 
已 经 实现 。 求 审查 。 "n 
No milestone 
" v 
IE] Add output GitHub $- Miele 
No one assigned 3» 
» yuria commented on 676c64d 1ib/fizzbuzz.rb:L9 11 months ago © A 
Notifications 
缩 进 好 像 不 太 对 。 
4* Unsubscribe 
» yuria commented 11 months ago 4 ©  2partcipants 
没有 关于 本 次 实现 的 测试 代码 ， 请 添加 一 份 。 
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专栏 : 获取 diff 格式 与 patch 格式 的 文件 
对 长 期 投身 于 软件 开发 的 人 来 说 ， 有 时 可 能 会 希 
式 文件 和 patch 格式 文件 的 形式 来 处 理 Pull Request。 
举 个 例子 ， 假 设 Pull Request 的 URL 如 下 所 示 。 



























































https://github.com/ 用 户 名 /仓库 名 /pull/28 














如 果 想 获取 diff 格式 的 文件 ， 只 要 像 下 面 这 样 在 URL 末 














望 以 diff 格 





Hl 





添加 .diff 即 可 。 




















https://github.com/ 用 户 名 /仓库 名 /pull1/28.diff 




















同 理 ， 想 要 patch 格式 的 文件 ， 只 需要 在 URL 末尾 添 


加 .patch 即 可 。 




















https://github .com/ 用 户 名 /仓库 名 /pul1/28.patch 


























想 要 diff 格式 与 patch 格式 文件 的 各 位 请 按照 上 
操作 。 


@ Conversation 


述 方法 进行 


在 Conversation 标签 页 中 ， 可 以 查看 与 当前 Pull Request 相关 的 所 
有 评论 以 及 提交 的 历史 记录 。 人 们 在 这 里 添加 评论 互相 探讨 ， 发 送 提交 
落实 讨论 内 容 的 整个 过 程 会 按时 间 顺 序列 出 ， 供 用 户 查 看 。 各 位 在 查看 











过 程 中 如 果 有 自己 的 想法 ， 不 妨 积极 地 添加 评论 参与 探讨 





o 











认 相 应 提交 的 





提交 日 志 的 右 侧 有 该 提交 的 哈 希 值 ， 点 击 链 接 即 可 硬 





详细 信息 。 


专栏 : 引用 评论 









































在 Conversation 中 人 们 通过 添加 评论 进行 对 话 。 这 里 有 一 




















个 简单 方法 可 以 帮 您 引用 某 个 人 的 评论 。 选 中 想 引 











的 评论 然 














[HI 











后 按 R 键 ， 被 选择 的 部 分 就 会 自动 以 评论 语法 写 入 评论 文本 














(Ka) 
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üt 








这 
中 同样 效 。 
图 a 按 R 键 引用 选中 的 部 分 


























半 一 来 就 可 以 轻松 便捷 地 引用 评论 了 。 该 快捷 键 在 Issue 








引用 评论 的 方法 #2 


hirocaster opened this issue just now - 0 comments 


4, hirocaster commented just now 


想 引 用 这 里 的 评论 时 ， 
只 要 选中 后 按 R 刍 便 会 自动 以 引用 形式 添加 到 评论 栏 中 。 


Write Preview 


> 只 要 选中 后 按 R 键 便 会 自动 以 引用 形式 添加 到 评论 栏 中 。 





选中 后 按 R 键 
Comments are parsed with GitHub Flavored Markdown 


Attach images by dragging & dropping, selecting them, or pasting from the clipboard. 


u 


4| 


一 Em 








€ Commits 














在 Commits 标签 页 
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1， 按 时 间 顺 序列 表 显 示 了 与 当前 Pull Request 


相关 的 提交 (图 5.21 )。 标 签 上 的 数字 为 提交 的 次 数 。 每 个 提交 右 侧 的 


喻 希 值 可 以 连接 到 该 提交 的 代码 。 


5.21 Pull Request 的 提交 一 览 





E] github-book /fizzbuzz 


Add output GitHub #1 


IE T. yuria merged 3 commits into master from 7-case-output-github 11 months ago 





G^Unwatch ~ 3 Sta 0 


ra EJ 


© 
M Conversation ® © Commits 3 [S] Files Changed 2 10 HEN n | 
-© Showing 3 unique commits by 1 author. m 
图 Mar 18, 2013 
»- 
W nirocaster Add output GitHub - 
E hiocaster — Fix indent fl5f in 


P Fork 2 
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专栏 : 在 评论 中 应 用 表情 

GitHub 的 文化 中 有 使 用 表情 的 习惯 。 表 情 种 类 繁多 ， 要 一 次 
全 记 下 来 十 分 困难 。 这 时 我 们 可 以 利用 表情 的 自动 补 全 功能 **。 
在 评论 中 输入 “:”( 冒号 ) 便 会 启动 表情 自动 补 全 功能 。 只 
要 输入 几 个 与 该 表情 相关 的 字母 ， 系 统 就 会 为 您 筛选 自动 补 全 的 
对 象 ( 图 a )。 选 择 想 要 的 表情 ， 其 相应 代码 ( 前 后 都 有 冒号 的 字 
符 串 ) 便 会 插入 到 文本 框 中 。 
准确 表达 感情 可 以 让 交流 变 得 和 谐 ， 各 位 请 记得 多 加 利用 。 




















































































































































































































图 a 自动 补 全 以 “ra” 开 头 的 表情 





Write Preview 


Ta 
pL | 
, rabbit2 
l ^y racehorse 
[a radio 


1 o radio button 














注 a 请 登录 http//www.emoji-cheatsheet.com/ 查找 可 使 用 的 表情 。 


e Files Changed 


Files Changed 标签 页 中 可 以 查看 当前 Pull Request 更 改 的 文件 内 容 
以 及 前 后 差别 。 标 签 上 的 数字 表示 新 建 及 被 更 改 的 文件 数 。 

默认 情况 下 系统 会 将 空格 的 不 同 也 高 亮 显 示 ， 所 以 在 空格 有 改动 的 
情况 下 会 难以 阅读 。 这 时 只 要 在 URL 的 末尾 添加 “?w=1” 就 可 以 不 显 
示 空 格 的 差别 。 

将 鼠标 指针 放 到 被 更 改行 行 号 的 左 侧 ， 我 们 会 看 到 一 个 加 号 。 点 击 
这 个 加 号 可 以 在 代码 中 插入 评论 (图 5.22 )。 这 样 ， 评 论 是 针对 哪 行 代 
码 的 就 一 目 了 然 了 。 

这 个 插入 评论 的 功能 让 针对 代码 的 讨论 变 得 十 分 顺畅 。 特 别 是 在 多 
人 协作 的 软件 开发 中 ， 这 个 功能 更 加 不 可 或 缺 。 
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图 5.22 ”对 所 选 内 容 行 进行 评论 
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Add output GitHub #1 


M Conversation ® © Commits 加 [S) Files Changed 2 
[E] Showing 2 changed files with 9 additions and 1 deletion. 


annnm lib/fizzbuzz.rb 


wo Write ^ Preview 


Leave a comment 


Attach images by dragging & dropping, selecting them, 


Close form 





'fizzbuzz' 


IE E yuria merged 3 commits into master from 7-case-output-github 11 months ago 


ce [Ig 
€» 
© 
e. 
n] 
Show Diff Stats 国 
la Op View 
" 
ln 


Comments are parsed with GitHub Flavored Markdown 


or pasting from the clipboard. aa 


Com on this line. 








5.8 Wiki 


Wiki 是 一 个 使 用 简单 的 语法 就 能 编写 文档 的 功能 (图 5.23 )。 所 有 
有 权限 的 人 都 可 以 对 文章 进行 修改 ， 所 以 比较 适合 多 人 共同 编写 文章 的 
情况 。 创 建 、 编 辑 文档 时 不 必 另 外 启动 软件 ， 用 起 来 十 分 方便 ， 非 常 适 
合用 来 针对 更 新 频率 较 高 的 软件 进行 文档 等 信息 方面 的 汇总 。 

Ej Issue 和 Pull Request 相同 ，Wiki 也 支持 GFM 语法 ， 所 以 可 以 轻 














松 创 建 表 现 力 丰 富 的 文档 。 点 击 
建新 的 Wiki 页 。 





























十 页面 右 上 角 的 New Page 按钮 便 可 以 创 








Wiki 功能 本 身 的 数据 也 在 Git 中 进行 管理 。 点 击 Clone URL AERIAL 


以 将 当前 Wiki 的 Git 仓库 URL 
操作 获取 Wiki 仓库 ， 然 后 在 本 ] 











复制 到 剪贴 板 中 。 用 户 能 够 通过 clone 
地 创建 、 编 辑 页 面 ， 进 行 提 交 再 push ， 




















便 可 以 完成 对 Wiki 的 创建 及 编辑 








工作 。 
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5.23 Wiki 的 应 用 实例 








E] clearsightstudio / ProMotion QiUnwath - 49| Star | ess | | PÈ Fork |52 





Home Pages History 











Home Page History Clone URL o 
Welcome to the ProMotion wiki! Please note that the current docs are targeting ProMotion mAPI Reference n 
version 1.0 which will be released shortly. 
c»AppDelegate 
Getting Started f A » 
Getting Started with ProMotion SScreens 
。 ProMotion::Screen 
Everything you need to know to install ProMotion and create your first iPhone app. = ProMotion::TableScreen p 
* table data options 
i = ProMotion:WebScreen 
Goal/Philosophy/Roadmap i EE 
ProMotion's goal is to create a memorable, simple, intuitive, and enjoyable API for rapidly «»Screen Helpers 
developing screen-based iPhone and iPad apps. P PrOMOIRE THUS 
= ProMotion::SplitScreen 
* Memorable: The API should be easy to memorize. Developers shouldn't have to be digging = ProMotion::Styling 
through documentation all the time to build out iOS apps. pln NoHDORHOnE 
* Simple: The API should utilize simple language, such as open , close , add , remove . 
Objective-C is far too verbose. eo 
= i "E 
在 Pages 标签 页 中 可 以 列表 查看 Wiki 页 面 (图 5.24 )。 
有 iki T 
5.24 Wiki 页 面 一 览 
E] clearsightstudio / ProMotion GiUnwath = 49 e Star 6M — V Fork s 
Home Pages History CI 
o 
* API Reference: ProMotlon::Delegate o 


e API Reference: ProMotion::Logger 

* API Reference: ProMotion::MapScreen n 
* API Reference: ProMotion::PushNotification 
+ API Reference: ProMotion::Screen 

* API Reference: ProMotion::SplitScreen 

+ API Reference: ProMotion::Styling ^ 
* API Reference: ProMotion::TableScreen 

* API Reference: ProMotion::Tabs 

* API Reference: ProMotion::WebScreen p 
e Apps bulit on ProMotion 

+ Basic Usage Examples 

* Guide: Formotion or other custom UlViewControllers 

* Guide: Getting Started 

* Guide: Push Notifications 

* Guide: Styling Your Views 

* Home 

« Reference: All available table data options 
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@ History 


5.8 Wiki 


在 History 标签 页 中 可 以 查看 Wiki 的 修改 历史 记录 (图 5.25 )。 
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IF Wiki 功能 也 有 历史 记录 可 查 ， 所 以 软件 开发 者 可 以 放心 地 投 


入 到 工作 中 去 。 将 Wiki 仓库 clone 到 本 地 ， 就 可 以 不 借助 浏览 带 ， 直 接 





Wiki, 





用 自己 熟悉 的 编辑 天 进 行 编辑 ， 十 分 人 性 化 。 
一 般 情况 下 ，Wiki 中 记载 着 软件 相关 的 FAQ 、 文 档 、 代 码 示例 及 
解说 等 信息 。 各 位 在 使 用 GitHub 上 开发 的 软件 前 ， 建 议 先 查看 一 遍 


5.25 Wiki 历史 记录 一 览 








Home Pages History 


History 


Compare Revisions 


O P -——— 
o b mam 
o Emm 
口 四 -= 一 -~ 
加 一 一 一 
E rrr 
B ee 
4H-—-—-- 
B 一 一 一 一 
E 一 一 一 
B 一 
Bee 


IO 


D|O|O|O|O 


[a] 





E] clearsightstudio / ProMotion BG Unwatch ~ 4 


6 days ago: Added section on beer judge. [72227bd] 

6 days ago: Add official app store icons to the page. Added section for BJCP Styles App. [b9daa93] 
6 days ago: Updated API Reference: ProMotion::Styling (markdown) dtc1514] 

6 days ago: Updated Reference: All available table. data options (markdown) [fa0c83a] 
6 days ago: added title view, tile view. height [0268093] 

6 days ago: Updated API Reference: ProMotion:Screen (markdown) [1683345] 

6 days ago: Created API Reference: ProMotion::SplitScreen (markdown) [2919564] 

6 days ago: Updated API Reference: ProMotion:Styling (markdown) [9445211] 

6 days ago: Created API Reference: ProMotion::Styling (markdown) [e339dd6] 

6 days ago: Updated API Reference: ProMotion::Screen (markdown) [afa73b1] 

6 days ago: Updated Home (markdown) [45e3f5] 


6 days ago: Updated Home (markdown) [a245d0b] 


P Star 644 


E Fork 52 


c 





专栏 : 在 Wiki 中 显示 侧 边栏 


所 有 Wiki 页 面 都 可 以 显示 侧 边 栏 。 做 法 很 简 让 
名 为 “_sidebar” 的 页 面 即 可 。_sidebar 页 不 会 显示 在 Pages 的 


页 面 一 览 中 。 在 编辑 各 页 面 时 页 面 下 部 会 附加 Sidebar B ( 图 








I Hn 














E, REGIE 



















































































可 以 在 这 里 编辑 侧 边栏 的 内 容 。 
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详细 解说 GitHub 的 功能 
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图 a 编辑 侧 边 栏 的 内 容 





v Sidebar 


* [HOME](https://github.com/hirocaster/sidebar/wiki) 

* 侧 边栏 1 

* 侧 边栏 2 

* 侧 边 栏 3 

<*「 编 辑 侧 边栏 1(httops://aithub.com/hirocaster/sidebar/wiki/ Sidebar/ edit) 


Edit Message 
Write a small message here explaining this change. (Optional) 


ES ~ 











5.9 Pulse 








Pulse 是 体现 该 仓库 软件 开发 活跃 度 的 功能 ( 图 5.26 )。 近 期 该 仓库 
创建 了 多 少 Pull Request 或 Issue， 有 和 多少 人 参与 了 这 个 仓库 的 开发 等 ， 





都 可 以 在 这 里 一 目 了 然 。 


5.26 Pulse 的 页 面 








E] twitter / bootstrap G5 Watch ~ 4282 k Star 53402 Į Fork 17,835 

July 15 2013 - July 22 2013 Period: 1 week ~ 
《> 

Overview 

© 

——— ——— 
25 active pull requests 110 active issues n 
1120 r5 G 96 014 + 

merged pull requests proposed pull requests closed issues new issues 

E 
m p 


26 authors have pushed 117 commits to all branches, 40 | 
excluding merges. On master, 0 files have changed and there — „, 
have been 0 additions and 0 deletions. 





im 
am 


o EM = — — — — — — — 一 — e 
u Wu MEE si 
® 19 Releases published by 1 person 
ECL v.00 5 days ago 
EX .1.05 days ago 
EL .1.1 5 days ago 








图 灵 社 区 会 员 lxghost2 专 享 尊重 版 权 





5.9 Pulse | 103 





根据 这 个 页 面 ， 用 户 可 以 判断 目前 这 个 软件 是 否 正在 被 积极 开发 ， 
或 者 持 有 仓库 修改 权限 的 人 是 否 在 认真 地 进行 BUG 修正 等 维护 工作 。 
在 挑选 GitHub 上 开发 的 软件 时 ， 它 可 以 作为 一 个 重要 的 衡量 标准 。 

下 面 ， 我 们 就 来 详细 讲解 一 下 这 个 功能 。 














@ active pull requests 

页 面 中 Overview 的 左 半 部 分 显示 了 特定 期 间 内 活动 过 的 Pull 
Request 数 。 图 5.26 中 有 25 个 Pull Request， 其 中 有 20 个 被 采纳 ， 其 余 
5 个 仍然 保持 Open 状态 。 剩 余 的 这 5 个 Pull Request 将 来 要 么 会 被 采 
纳 ， 要 人 么 会 被 Close。 

如 果 想 查看 清单 的 详细 内 容 ， 只 要 点 击 对 应 项 即 可 (图 5.27 )。Pull 
Request 的 概要 及 链接 按照 合并 的 先后 顺序 排列 。 


图 5.27 已 合并 的 Pull Request 的 概要 及 链接 


1120 Pull Requests merged by 17 people 









































EZEZ #8549 Updated readme.md to reflect the latest changes in directory structure 16 hours ago 
EZEZ #8546 Fixed typo a day ago 
EZEZ 46545 refactor button-groups.less a day ago 


EZEZ #8544 remove useless display:inline-block a day ago 








EE #8538 Update Normalize.css URL to new Github.io domain 2 days ago 





点 击 proposed-pull-request 则 可 以 按 创建 的 先后 顺序 查看 Pull 
Request 的 概要 及 链接 。 

通过 这 些 信息 ， 用 户 可 以 了 解 该 软件 最 近 正 在 开发 哪些 功能 。 如 果 
发 现 对 方正 在 进行 功能 扩展 或 者 修正 ， 不 妨 积极 试用 一 下 这 个 功能 。 这 
或 许 会 成 为 您 加 入 开源 软件 开发 的 契机 。 








@ active issue 
页 面 中 Overview 的 右 半 部 分 显示 了 特定 期 间 内 活动 过 的 Issue 数 。 
图 5.26 中 有 110 个 Issue， 其 中 有 96 个 被 Close， 其 余 14 个 仍 处 于 


Open 状态 。 
如 果 想 查看 清单 的 详细 内 容 ， 只 要 点 击 对 应 项 即 可 。Issue 的 概要 及 
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链接 按照 Close 的 先后 顺序 排列 。 

点 击 new issue 则 可 以 按 创 建 的 先后 顺序 查看 Issue 的 概要 及 链接 。 
通过 观察 Issue 的 整体 动向 ， 用 户 能 够 知道 这 个 软件 是 否 有 人 在 积 
极地 维护 与 支持 。 对 方 仓 库 越 是 活跃 ， 用 户 发 送 的 BUG 报告 和 相关 探 
讨 越 可 能 收 到 回应 。 



































6 commits 


Overview 下 方 显示 的 是 与 提交 相关 的 信息 。 左 侧 部 分 包含 了 如 下 几 
类 信息 。 








* 编写 过 代码 的 人 数 

。 提交 的 次 数 

* default branch 中 修改 过 的 文件 数 
* default branch 中 添加 的 行 数 

* default branch 中 删除 的 行 数 











通过 这 些 信息 ， 用 户 可 以 大 致 把 握 该 仓库 中 活跃 开发 者 的 人 数 。 
男 外 ， 右 侧 图 表 显 示 了 这 些 开 发 者 具体 发 送 的 提交 数 。 通 过 图 表 我 
们 可 以 了 解 到 有 哪些 开发 者 在 格外 积极 地 向 该 仓库 发 送 提交 。 









































e Releases published 











提交 相关 信息 的 下 方 显示 了 “5 Releases published” 之 类 的 字样 ， 
这 是 版 本 发 布 的 相关 信息 。 已 发 布 的 各 版 本 的 下 载 链接 按照 发 布 时 间 的 
先后 顺序 一 一 列 出 。 
通过 这 里 我 们 可 以 了 解 到 该 软件 的 版 本 升级 频率 。 




















6 Unresolved Conversations 





最 后 我 们 来 讲解 显示 为 “4 Unresolved Conversations” 的 这 个 部 分 。 
这 里 列 出 的 Issue 和 Pull Request 都 创建 于 Period 指定 的 时 间 之 前 ， 
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它们 都 尚未 Close 并 且 仍 有 人 参与 评论 。 一 般 情 况 下 ， 仓 库 中 软件 的 重 
大 事项 讨论 都 会 持续 很 长 时 间 ， 所 以 这 些 讨论 大 多 放 在 这 里 。 其 中 会 有 
不 少 关 于 该 软件 今后 发 展 方向 的 讨论 。 如 果 各 位 有 哪些 比较 关心 的 软 
件 ， 不 妨 关 注 一 下 这 部 分 的 讨论 内 容 。 























5.10 Graphs 





在 Graphs 页 中 ， 可 以 通过 4 种 图 表 查 看 该 仓库 的 相关 统计 信息 
(图 5.28 )。 利 用 图 表 直 观 地 汇总 信息 ， 可 以 让 用 户 把 握 当 前 仓库 的 各 种 
趋势 。 下 面 ， 让 我 们 来 了 解 一 下 每 个 图 表 所 包含 的 信息 。 


图 5.28 Graphs 
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6 Contributors 


在 Contributors 的 图 表 中 ， 我 们 可 以 看 到 每 个 用 户 在 相应 日 期 中 发 
送 提交 、 添 加 代码 、 删 除 代码 的 大 致 数量 ( 图 5.29 )。 从 这 里 我 们 能 够 
了 解 到 该 仓库 的 代码 主要 由 哪些 人 编写 。 而 且 ， 还 可 以 通过 图 表 分 析出 
该 软件 大 幅 修改 阶段 和 稳定 维护 阶段 的 相应 时 期 。 
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5.29 Contributors 





Ej twitter / bootstrap Gi Watch ~ w Star 52739 [f Fork 17,263 


Contributors Commits Code Frequency Punchcard 
April 24th 2011 - June 16th 2013 
Commits to master, excluding merge commits Contribution Type: Commits ~ © 


250 


150 

10 ES 
5o 

ANE Y 要 区 

duy October. 2012 Apri Juy October 2013 April 
v 
1 - 2 
1,703 commits 07 ++ /116,383 — 636 commits / 100,579 ++ /80,567 — 


onz mi2 om mi Ý oar om om 














另外 ， 这 些 图 表 的 统计 中 还 包括 发 送 Pull Request 被 采纳 后 产生 的 
代码 增 减 。 


€ Commit Activity 

Commit Activity 中 显示 了 一 年 内 ( 52 周 ) 每 周 收 到 的 提交 的 大 致 数 
量 ( 图 5$.30)。 第 二 张 表 中 还 可 以 查看 相应 周 每 天 的 提交 数量 。 判 断 某 
个 仓库 是 否 有 人 在 积极 更 新 时 ， 这 部 分 是 一 个 重要 的 指标 。 

















€ Code Frequency 

Code Frequency 中 显示 了 该 仓库 中 代码 行 数 的 增加 量 和 删除 量 ( 图 
5.31 )。 一 款 优秀 的 软件 并 不 会 一 味 地 增加 代码 ， 在 经 过 重 构 之 后 ， 代 码 
量 往往 会 降低 。 通 过 这 张 图 ， 我 们 可 以 直观 地 把 握 相 应 信息 。 
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E] 5.30 | Commit Activity 
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@@ Punchcard 


从 Punchcard 的 图 中 我 们 可 以 直观 地 掌握 一 周 内 每 天 何 时 收 到 的 提 
交 最 多 ( 图 5.32 )。 黑 色 圆 越 大 ， 表 示 提 交 越 频繁 。 





5.32 punchcard 


























E] twitter / bootstrap 





G5 Watch ~ 


Contributors Commits Code Frequency Punchcard 


** Star 52,781 P Fork 17291 








“ Oooo. ..... 0000000. 0000 ^ 
wy 00.. .e00000000000 0000 : 
w— Ooo *»«0000000*20000000 + 
Wes ，@e。 eeeeeeeeeeg@g@ 
murs |» eee eeeeee eg@g@eg@ 

ZEE ND eeeeeeeee@ee@eeg 

sy (Qe e :"»..e.000000029000 

仓库 的 关键 人 物 往 往 会 出 现在 提交 频率 高 的 时 间 段 ， 因 此 用 户 发 送 
的 Pull Request 最 有 可 能 在 这 段 时 间 内 被 处 理 。 大 致 了 解 时 间 规 律 ， 将 








有 


软件 的 开发 是 




















助 于 各 位 把 握 好 发 送 Pull Request 以 及 等 待 回复 的 时 间 点 。 另 外 ， 该 











5.11 Network 


中 在 早上 还 是 晚上 上， 从 这 张 图 中 也 可 一 目 了 然 。 


以 图 表 形 式 显示 包括 克隆 仓库 在 内 的 所 有 分 支 的 提交 (图 5.33 )。 











图 上 可 以 直观 地 看 出 每 个 人 做 了 多 少 工作 。 





将 鼠标 指针 停留 在 表 中 提交 或 合并 的 点 上 ， 可 以 查看 相应 的 参考 


pz 


To 
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Graph Members 
The wdpress69 network graph 


Show Help 


19 20 


ar 


hirocaster 


All branches in the network using hirocaster/wdpress69 as the reference point. Read our blog post about how it works 
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GitHub Network Graph Viewer v4.0.0 











5.12 Settings 





RU H 
这 个 页 面 。 





F 何 设 











置 。 用 户 必 须 拥 有 更 改 设置 的 权限 ， 





e Options 





在 Options 中 可 以 变更 仓库 本 身 的 相关 设置 (图 5.34 )。 


@ Settings 




















在 这 里 可 以 修改 仓库 名 称 ， 设 置 显 示人 仓库 URL 时 默认 显示 的 分 支 。 
这 个 默认 分 支 同 时 也 是 创建 Pull Request 时 的 默认 值 ， 如 果 各 位 的 主 分 
图 灵 社区 会 员 
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支 不 是 master 分 支 ， 建 议 更 改 这 一 设置 。 


5.84 Settings 的 Options 页 面 





Q settings 
Repository Name 


wdpress69 Rename 


Default Branch | gh-pages $| 


© Features 


M Wikis 
GitHub Wikis are the simplest way to let others contribute content. Any GitHub user can create and edit 
pages to use for documentation, examples, support or anything you wish. 


O Restrict edits to Collaborators only 
Public Wikis will still be readable by everyone. 


(vf Issues 
GitHub Issues adds lightweight issue tracking tightly integrated with your repository. Add issues to 
milestones, label issues, and close & reference issues from commit messages. 


© GitHub Pages 


Your site is published at http://hirocaster.github.io/wdpress69 


Update your site 


Easily change your content or theme with the page generator. Automatic Page Generator 


To publish a page manually, push an HTML or jekyll site to your gh-pages branch. More info. 


Make this repository private 


Hide this repository from the public. Make private 


Transfer Ownership 








Transfer this repo to another user or to an organization where you have admin rights. Transfer 





- € Features 





这 里 可 以 更 改 Wiki 和 Issue 的 相关 设置 。 如 果 想 关闭 某 些 功能 ， 只 
要 取消 已 勾 选 的 相应 复 选 框 ， 该 功能 就 会 从 菜单 中 移 除 ， 无 法 使 用 。 
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e 6 GitHub Pages 


GitHub 有 一 个 名 为 GitHub Pages 的 仓库 ， 用 户 可 以 利用 该 仓库 中 的 
资料 创建 Web 页 ， 用 来 发 布 仓库 中 软件 的 相关 信息 。 如 果 已 经 创建 过 
GitHub Pages， 则 会 显示 相应 URL。 点 击 Automatic Page Generator 即 可 
以 自动 创建 GitHub Pages。 

















e © Danger Zone 








这 里 都 是 一 些 需 要 格外 留意 的 设置 。 在 这 里 ， 用 户 可 以 将 仓库 改 为 
私有 或 是 变更 仓库 所 有 者 ， 甚 至 删除 仓库 本 身 。 这 些 设置 有 可 能 影响 到 
其 他 人 ,在 变更 时 一 定 要 谨慎 。 





























@ Collaborators 














户主 要 在 这 里 设置 仓库 的 访问 权限 。 如 果 仓 库 隶 属于 个 人 账户 ， 
那么 可 以 像 图 5.35 所 示 那 样 添加 GitHub 的 用 户 名 ， 赋 予 该 用 户 直接 读 
写 仓库 的 权限 。 


图 5.35 ”个 人 账户 的 Collaborators 页 面 




















Manage Collaborators 
d-ikeda (remove) 


zogata (remove) 


Add a friend Add 











不 过 ， 如 果 仓 库 隶 属于 Organization 账户 ， 则 需要 像 图 5.36 所 示 的 
那样 先 创建 Team， 然 后 赋予 该 Team 读 写 仓库 的 权限 。 

像 这 样 使 用 Organization 账户 可 以 高 效 地 设置 仓库 权限 ， 在 公司 等 
多 人 共同 进行 开发 的 组 织 中 ， 建 议 使 用 Organization 账户 。 
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5.36 ”Organization 账户 的 Collaborators 页 面 





Teams 


Q3 github-book/owners 


| Choose a team :| Add 


Usage for this repository is billed to github-book 


Everyone with access 


IB] nirocaster 











6 Webhooks & Services 


在 这 个 页 面 中 ， 用 户 可 以 添加 Hook 让 GitHub 仓库 与 其 他 服务 集 
成 。 通 过 Add webhook 可 以 添加 用 户 自己 的 webhook。 通 过 Configure 
services 则 可 以 从 GitHub 事先 列 出 的 可 以 集成 的 服务 中 进行 选择 。 能 与 
GitHub 集成 的 服务 非常 多 ， 其 中 还 包括 邮件 及 IRC 等 社交 服务 ， 建 议 
各 位 不 要 错过 这 个 设置 。 在 如 此 大 量 的 服务 当中 ， 相 信 各 位 能 找到 自己 
正在 使 用 的 工具 。 












































e Deploy Keys 


在 这 个 页 面 中 ， 用 户 可 以 添加 用 于 部 署 的 公开 密 钥 ， 人 允许 以 只 读 方 式 
访问 仓库 。 设 置 公 开 密 钥 后 ， 用 户 可 以 使 用 私有 密 钥 通 过 ssh 协议 clone 仓 
库 。 要 注意 的 是 ， 这 里 添加 的 公开 密 钥 ， 私有 密 钥 对 无 法 再 添加 到 其 他 
仓库 。 使 用 Deploy Keys 功能 时 ， 需 要 给 每 个 仓库 赋予 不 同 的 密 钥 对 。 









































5.13 Notifications 





页 面 左上 角 LOGO 旁边 的 蓝 色 亮点 就 是 Notifications。 点 击 它 ， 我 
们 可 以 看 到 GitHub 所 有 活动 的 通知 (图 $.37)。 有 灵活 运用 这 个 
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Notifications， 可 以 大 幅 提高 合作 开发 的 效率 。 


Notifications 
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5.37 Notifications 的 页 面 
Notifications Watched Repositories Mark everything as read 


Participating 0 © Updates README 


All notifications © puppet-sequelpro 


tddbc/scala_scalatest s 

© Makefile MEHM 
tddbc/organizers. 

RubyMotionTokyo/M.... 


tddbc/gcc47-boost-test boxen/puppet-ruby 


Tl First spike at jruby 





T) Finishing touches for Ri 


© xcrun invalid option on OS X 10.9 

boxen/puppet-ruby " 
alnamafiaption-node. i © Can we get Puppet Postbox pulled in? 
kmuto/review 8 
tddbc/ruby. rspec 6 hirocaster/wdpress69 
boxen/our-boxen 4 T] Add my impression 
tddbc/javascript. qunit 2 
lokka/lokka 2 T) Add my impression 
tddbc/ava. unit 2 
We 2 tddbc/gcc47-boost-test 

1 

1 

1 

1 


uby 2.0.0-p247 


| annouraoo 
里 11 hoursago 
Bl 52 
EZ 2 days ago 


Ù adayago 


ud 6 days ago 


两 :cao 


ü 4 months ago 
A 3 days ago 


4 


4 


* 





~ 





每 当 创 建 Issue 、 收 到 评论 、 
就 会 在 Notifications 中 收 到 通知 。 
Ji If 




















| 左 侧 是 Notifications Iff 





创建 Pull Request 等 情况 发 生 时 ， 我 们 











相关 的 通知 ， 














选 器 ， 可 以 分 别 查 看 未 读 的 、 与 自己 
或 者 按 仓库 分 类 查看 通知 等 。 


点 击 仓库 名 右 侧 的 对 勾 ， 可 以 将 该 仓库 的 所 有 Notifications 设置 为 


已 读 状态 。 








点 击 各 条 通知 右 侧 的 扩 音 器 图 标 ， 那么 即使 今后 这 个 通知 的 相关 内 
下 通知 用 户 。 点 击 通知 右 侧 的 对 勾 ， 可 以 
将 相应 的 Notifications 设置 为 已 读 状 态 。 当 然 ， 点 击 Notifications 阅读 
详细 内 容 后 ， 该 通知 也 会 自动 转换 为 已 读 状态 。 





容 再 收 到 追加 评论 时 ， 也 不 会 再 





如 果 LOGO 旁 的 蓝 色 亮点 是 
请 养 成 及 时 查看 的 习惯 。 越 早 处 


图 灵 社 区 会 








理 通 知 ， 开 


员 Ixghost2 专 享 尊重 版 权 


是 发 光 状 态 ， 则 表示 有 未 读 的 Notifications, 
发 者 之 间 的 协同 工作 就 越 有 
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5.14 ”其 他 功能 
GitHub 还 提供 了 其 他 许多 功能 。 我 们 在 这 里 只 介绍 其 中 的 一 部 分 。 


e GitHub Pages 


GitHub Pages 主要 用 于 在 GitHub 上 托管 静态 HTML， 以 便 发 布 项 
目的 Web 页"。 
由 于 可 以 绑 定 独立 域名 ， 人 们 也 经 常 利用 结合 了 这 个 功能 的 
Octopress? 框架 来 搭建 博客 。 有 兴趣 的 读者 不 妨 试 一 试 。 























e GitHub Jobs 


GitHub Jobs 是 面向 全 世界 招聘 程序 员 的 职位 公告 板 ”。 

450 美元 可 以 发 布 30 天 招聘 公告 ， 希 望 在 世界 范围 内 招聘 优秀 程序 
员 的 公司 不 妨 尝试 一 下 这 个 功能 。 

想到 海外 就 职 的 程序 员 也 可 以 多 看 一 看 这 里 。 

















€ GitHub Enterprise 


GitHub Enterprise 专 为 那些 无 法 将 源 代 码 放 到 公司 之 外 的 企业 设计 。 
这 项 服务 可 以 以 虚拟 机 的 形式 提供 GitHub。 申 请 后 可 以 先 试用 45 K, 
所 以 企业 内 部 在 探讨 是 否 导 和 人 时 可 以 实际 使 用 一 下 再 决定 。 

导入 的 最 大 阻碍 其 实 是 成 本 。 这 项 服务 主要 面向 20 人 以 上 的 组 织 ， 
如 果 规 模 不 足 ， 建 议 还 是 使 用 普通 的 GitHub。 详 细 内 容 请 参照 GitHub 
Enterprise HJ jii 

考虑 到 实体 机 的 运行 成 本 及 维护 成 本 ， 除 非 是 规模 相当 大 的 企业 ， 


















































https://pages.github.com/ 
http://octopress.org/ 
https://jobs.github.com/ 
https://enterprise.github.com/pricing 


OONO 
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否则 还 是 不 建议 使 用 GitHub Enterprise. 


e GitHub API 


GitHub 面向 开发 者 公开 了 API。 特 别 是 在 开发 面向 程序 员 的 Web 
服务 时 ， 能 与 GitHub 集成 绝对 有 利 无 刺 。 详 细 内 容 请 参照 官方 网 站 O, 




















5.15 小结 





本 章 中 ， 我 们 结合 GitHub 的 实际 操作 页 面 给 各 位 讲解 了 GitHub 上 
提供 的 各 项 功能 。 其 中 某 些 功能 的 细节 可 能 经 常 使 用 GitHub 的 人 也 并 
不 完全 清楚 。 

在 GitHub 上 与 其 他 人 共同 进行 软件 开发 时 ， 如 果 发 现 同 组 搭档 对 
功能 不 够 熟悉 ， 不 妨 按照 本 书 中 的 介绍 为 其 讲解 一 番 。 











专栏 : 在 Mac 的 通知 中 心 查看 GitHub 的 Notifications 


OS X 从 10.8 Mountain Lion 版 本 开始 添加 了 通知 中 心 的 功 
能 ， 该 功能 用 于 简单 汇总 并 显示 应 用 程序 的 警告 。 

GitHub 为 Mac 准备 了 专用 的 客户 端 软件 *。 利 用 这 个 软件 ， 
就 可 以 通过 GUI 完成 仓库 的 简单 操作 。 不 仅 如 此 ， 只 要 这 个 
软件 在 运行 ，GitHub 的 Notifications 收 到 的 内 容 就 会 同时 显示 
在 通知 中 心中 ( 图 a )。 

GitHub 的 客户 端 部 署 版 本 GitHub Enterprise 也 支持 这 一 功 
能 。 只 要 在 同一 客户 端的 设置 页 面 ( 图 b ) 进行 设置 ， 通 知 中 心 
就 能 够 同时 接收 GitHub.com 和 GitHub Enterprise 双方 的 通知 。 
常 使 用 GitHub 的 各 位 请 务必 一 试 。 
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注 a https://mac.github.com/ 





(D https://developer.github.com/ 
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第 5 章 详细 解说 GitHub 的 功能 


图 a 通知 中 心 接收 GitHub 的 通知 








boxen/our-boxen 
#340: Updating Boxen 








图 b GitHub Enterprise 的 设置 








GitHub.com Login 
Hiroki OHTSUKA 


hirocaster 


Accounts 


Sign Out 





GitHub Enterprise Login 


Drs iue enemu De add your [ Aad an Enterprise Account ] 
Tegin herska Baie MS SQUE Add an Enterprise Account. 
Find out more about GitHub Enterprise 
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按部就班 地 创建 GitHub 账号 并 公开 自己 的 源 代 码 并 不 是 什么 难事 。 
不 过 ， 刚 刚 接触 GitHub 的 人 往往 不 会 或 不 敢 使 用 Pull Request 功能 。 

Pull Request 是 社会 化 编程 的 象征 。GitHub 创造 的 这 一 功能 ， 可 以 
说 给 开源 开发 世界 带 来 了 一 场 革命 。 不 会 用 这 个 功能 ， 就 等 于 不 会 用 
GitHub, 

不 过 ， 掌 握 Pull Request 的 难度 确实 较 高 ， 刚 刚 接触 GitHub 的 人 在 
发 送 Pull Request 时 ， 往 往 会 遇 到 找 不 到 对 方 的 项 目 或 者 不 知道 该 如 何 
发 送 等 问题 。 

所 以 ， 本 书 将 为 各 位 创造 一 个 杂 自 动手 发 送 Pull Request 的 机 会 ， 
请 各 位 不 要 错过 。 







































































6.1 Pull Request 的 概要 


@ 什么 是 Pull Request 


首先 我 们 来 理解 什么 是 Pull Request", Pull Request 是 自己 修改 源 代 
人 码 后 ， 请 求 对 方 仓库 采纳 该 修改 时 采取 的 一 种 行为 。 

















@ Pull Request 的 流程 


下 面 来 看 看 具体 的 例子 。 现 在 假设 我 们 在 使 用 GitHub 上 的 一 款 开 
源 软 件 。 

在 使 用 这 款 软 件 的 过 程 中 ， 我 们 偶然 间 发 现 了 BUG。 为 了 继续 使 
用 软件 ， 我 们 手动 修复 了 这 个 BUG。 如 果 我 们 修改 的 这 上 段 代码 能 被 该 
软件 的 开发 仓库 采纳 ， 今 后 与 我 们 同样 使 用 这 款 软件 的 人 就 不 会 再 遇 到 
这 个 BUG。 为 此 ,我 们 要 第 一 时 间 发 送 Pull Request, 

在 GitHub 上 发 送 Pull Request 后 ， 接 收 方 的 仓库 会 创建 一 个 附带 源 
代码 的 Issue ， 我 们 在 这 个 Issue 中 记录 详细 内 容 。 这 就 是 Pull Request. 












































(D Pull Request 在 网 络 上 也 常常 被 简称 为 PR. 
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发 送 过 去 的 Pull Request 是 否 被 采纳 




















， 要 由 接收 方 仓库 的 管理 者 进 








行 判 断 。 一 般 只 要 代码 没有 问题 ， 对 方 都 会 采纳 。 如 果 有 问题 ， 我 们 会 





收 到 评论 。 
只 要 Pull Request 被 顺利 采纳 ， 我 们 就 
(贡献 者 )， 我 们 编写 的 这 段 代码 也 将 被 全 1 








会 成 为 这 个 项 目的 Contributor 
此 界 的 人 使 用 。 这 正 是 社会 化 


























编程 和 开源 开发 的 一 大 乐趣 。 











我 们 为 本 书 专门 搭设 了 一 个 网 站 ， 各 位 可 以 对 其 进行 修改 ， 洽 试 发 


送 Pull Request。 


6.2 发 送 Pull Request 前 的 准备 


整体 概念 如 图 6.1 所 示 。 


图 6.1 Pull Request 的 概念 图 
































GitHub 
ituring/ PI 
first-pr first-pr 
Cr... Fork Ff. 
Pull Request 





r——7 sam 
git 
C C 
d 


创建 特性 分 支 


各 位 读者 
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e 查看 要 修正 的 源 代码 


请 登录 我 们 为 各 位 准备 的 网 站 “。 该 网 站 的 源 代码 已 经 在 GitHub 上 
公开 。 各 位 i idi 自己 的 感想 写 入 源 代码 ， 然 后 发 送 Pull Request. 
个 网 站 通过 GitHub 的 GitHub Pages 功能 发 布 。GitHub Pages 的 
a gh-pages 分 支 。 访 问 仓库 页 面 ， 我 们 就 可 以 看 
到 源 代码 。 
记述 感想 时 需要 修改 index.html 文件 。 各 位 不 妨 先 查 看 它 的 源 代码 ， 
对 内 容 有 个 印象 。 





0 Fork 


各 位 请 访问 仓库 页 面 ， 点 击 Fork 按钮 创建 自己 的 仓库 (图 6.2 )。 
新 建 的 仓库 名 为 “自己 的 账户 名 /first-pr”"。 在 这 里 我 们 命名 为 


hirocastest。 


6.2 Fork 按钮 





Gi Watch ~ 118 | 4 Unstar 124 j^ Fork 289 











6 clone 


clone 仓库 所 需 的 访问 信息 显示 在 右 侧 的 中 央 部 分 ， 让 我 们 将 它 复 
制 下 来 ， 把 这 个 仓库 clone 到 当前 的 开发 环境 中 。 


$ git clone git@github.com:hirocastest/first-pr.git 





Cloning. into 'Eirst-pDr'.. 

remote: Counting objects: 14, done. 

remote: Compressing objects: 100% (12/12), done. 
remote: Total 14 (delta 2), reused 0 (delta 0) 
Receiving objects: 100% (14/14), 24.05 KiB, done. 
Resolving deltas: 100% (2/2), done. 

$ cd first-pr 





(D https://ituring.github.io/first-pr/ 
Q) https;//github.com/ituring/first-pr 
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first-pr 目录 下 会 生成 Git 仓库 。 这 个 仓库 与 我 们 GitHub 账户 下 的 
first-pr 仓库 状态 相同 。 现 在 只 要 在 这 个 仓库 中 修改 源 代码 进行 push, 
GitHub 账户 中 的 仓库 就 会 被 修改 。 

















@ branch 
e 为 何 要 在 特性 分 支 中 进行 作业 


当前 Git 的 主流 开发 模式 都 会 使 用 特性 分 支 。 关 于 特性 分 支 的 详细 
知识 ， 我 们 已 经 在 第 4 章 讲 解 过 了 。 

各 位 请 养 成 创建 特性 分 支 后 再 修改 代码 的 好 习惯 。 在 GitHub 上 发 
送 Pull Request 时 ， 一 般 都 是 发 送 特性 分 支 。 这 样 一 来 ，Pull Request 就 
拥有 了 更 明确 的 特性 (主题 )。 让 对 方 了 解 自己 修改 代码 的 意图 ， 有 助 
于 提高 代码 审查 的 效率 。 

















我 们 来 查看 一 下 clone 出 的 仓库 的 分 支 。 


$ git branch -a 

* gh-pages 全 当前 分 支 
remotes/origin/HEAD -> origin/gh-pages 
remotes/origin/gh-pages 


开头 加 了 “remotes/origin/” 的 是 GitHub 端 仓库 的 分 支 。 我 们 手头 
的 开发 环境 中 只 有 gh-pages 分 支 。 

网 站 中 显示 的 HTML 位 于 /origin/gh-pages 分 支 。 虽 然 通常 情况 下 
最 新 版 代码 都 位 于 master 分 支 ， 但 由 于 本 次 我 们 使 用 了 GitHub Pages, 
所 以 最 新 代码 位 于 gh-pages 分 支 。 
































@…… 创建 特性 分 支 


我 们 创建 一 个 名 为 work 的 分 支 ， 用 来 发 送 Pull Request。 这 个 work 
分 支 就 是 这 次 的 特性 分 支 。 现 在 创建 work 分 支 并 自动 切换 。 


$ git checkout -b work gh-pages 








Switched to a new branch 'work' 
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确认 是 否 切换 到 了 work 分 文 下 。 


$ git branch -a 
gh-pages 
* work “当前 分 支 





remotes/origin/HEAD -> origin/gh-pages 
remotes/origin/gh-pages 








查看 文件 列表 ， 我 们 可 以 看 到 网 站 中 显示 的 index.html 文件 。 
S al 


README .md index.htm. params.json 


images javascripts stylesheets 


nILUHDUA 81 IIFA VGZ o 




















e 添加 代码 


用 编辑 器 打开 index.html 文件 ， 以 HTML 形式 添加 感想 


DNDN O 





省 略 


<p> 请 写 明 这 是 对 本 书 内 容 的 实践 或 描述 对 本 书 的 感想 并 发 送 Pull Requesto </p> 














| 追加 的 行 





«p class="impression"> 这 本 书 读 着 很 有 趣 。 ( @HIROCASTER ) </p> 
省 略 


请 自由 添加 感想 并 用 p 标签 (Tag) 括 起 ， 然 后 关闭 编辑 器 。 





@ 提交 修改 

















用 git diff 命令 查看 修改 是 否 已 经 正确 进行 。 


$ git diff 








diff --git a/index.html b/index.html 
index f2034b3..91b8ecb 100644 

--- a/index.html 

+++ b/index.html 

@@ -39,6 «39,8 @@ 








<p> 请 写 明 这 是 对 本 书 内 容 的 实践 或 描述 对 本 书 的 感想 并 发 送 Pull Requesto </p> 











+<p class="impression"> 这 本 书 读 着 很 有 趣 。 ( @HIROCASTER ) </p> 
T 


省 略 
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| 12 


3 


WRAAE, Sut onde IENR. RARI, DE 


交 至 本 地 仓库 。 


$ git add index.html 
$ git commit -m "Add my impression" 
[work 243f28d] Add my impression 





1 file changed, 2 insertions (+) 


e 创建 远程 分 支 


要 从 GitHub 发 送 Pull Request，GitHub 端的 仓库 中 必须 有 一 个 包 








含 了 修改 后 代码 的 分 支 。 我 们 现在 就 来 创建 本 地 work 分 支 的 相应 


4 36e 


$ git push origin work 
Counting objects: 5, done. 
Delta compression using up to 4 threads. 
Compressing objects: 100$ (3/3), done. 
Writing objects: 100% (3/3), 353 bytes, done. 
Total 3 (delta 2), reused 0 (delta 0) 
To gitGgithub.com:hirocastest/first-pr.git 

* [new branch] work -» work 


查看 分 支 ，/origin/work C988 


$ git branch -a 





Ha 


master 

* work 

remotes/origin/HEAD -» origin/master 
remotes/origin/gh-pages 
remotes/origin/work ”已 被 创建 


远程 


器 





请 打开 GitHub 的 “用 户 名 /first-pr” 页 ， 确 认 work 分 支 是 否 被 创 


建 ， 以 及 是 否 已 包含 我 们 添加 的 代码 。 


6.3 发 送 Pull Request 


参考 图 6.3， 登 录 GitHub 并 切换 至 work 分 支 。 点 击 分 支 名 左 侧 的 








绿色 按钮 ， 会 跳 转 至 查看 分 支 间 差别 的 页 面 (图 6.4) 请 在 这 里 
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别 查 看 刚刚 进行 的 更 改 是 否 正确 。 这 里 显示 的 东西 就 是 我 们 本 次 Pull 
Request 中 包含 的 提交 。 


6.3 “切换 分 支 





Sg] [ b branch: onpages 7 ) first-pr /:& 





ü I Switch branches/tags | 





ga hi | Find or create a branch... | 
| | 
ER ‘i | 


Branches Tags 





um jam 


WES work 











E] README.md Update README 





6.4 “查看 分 支 间 差别 的 页 面 





t Woh-pages .. P work 


Edit 
TON 
Open a Pull Request for this comparison to discuss and review your changes with others. © 
1 commit 1 file changed 0 comments 1 contributor 


Aug 22, 2013 
[Ed hirocaster Add my impression 
F] Showing 1 changed file with 3 additions and 1 deletion. 


4 BEBE“ index.html 


ee -1,4 +1,4 ee 

1 -«IDOCTYPE html» 
*«IDOCTYPE html» 
<html> 


<head> 

ee -67,6 +67,8 ae <h2 id="project_tagline">WEB+DB PRESS Vol.69 GitHub 特 集 </p> 开 发 工具 
«p» (现在 已 收 到 <span id="impression_num"></span> 条 感想 。</p> 

+<p class="impression"> 这 是 第 一 次 发 Pull Request。</p> 

E 


<p class="impression"> 我 越 来 越 理解 GitHub 了 。</p> 


<p class="impression"> 我 是 第 一 次 用 GitHub。 初 学 者 也 能 轻松 看 懂 这 本 书 ， 让 我 顾 利 地 理解 了 整个 流程 。</p> 


No commit comments for this range 





























确认 想 要 发 送 的 Pull Request 的 内 容 差 别 无 误 后 ， 请 点 击 Create Pull 
Request。 随 后 显示 的 表单 用 于 填写 请 求 对 方 采 纳 的 评论 ( 图 6.5 )。 现 在 
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让 我 们 在 评论 栏 中 简明 扼要 地 描述 本 次 进行 Pull Request 的 理由 。 
图 6.5 ”填写 请 求 对 方 采纳 的 评论 








Write Preview Comments are parsed with GitHub Flavored Markdown v Able to merge 
Fe These branches can be 
Leave a comment a automatically merged 
4 
Attach images by dragging & dropping, selecting them, or pasting from the clipboard. Send pull request 











确认 没有 问题 后 ， 点 击 Send pull request 按钮 。 这 样 一 来 ，Pull 
Request 的 目标 仓库 中 就 会 新 建 Pull Request 和 Issue， 同 时 该 仓库 的 管 
理 者 会 接 到 通知 。 











至 此 ， 蕉 喜 各 位 顺利 发 送 了 第 一 次 的 Pull Request。 现 在 我 们 发 送 
的 源 代 码 还 没有 被 采纳 ， 对 方 仓库 不 会 有 任何 变化 ， 所 以 网 页 也 仍然 
是 原样 。 

如 果 想 查看 已 发 送 Pull Request 的 状态 ， 可 以 登录 GitHub, FJI A 
己 的 控制 面板 查看 Pull Request 标签 页 。 点 击 自己 发 送 的 Pull A 后 
会 进入 如 图 6.6 的 页 面 ， 管 理 者 对 Pull Request 的 评论 会 发 到 这 里 。 这 些 
在 Conversation 标签 页 中 会 按照 时 间 顺 序 排列 显示 。 只 要 代码 没有 问题 ， 
我 们 的 Pull Request 就 会 被 采纳 “。 

















(D 本 书 中 出 现 的 示例 仓库 ， 现 阶段 将 主要 由 译 者 及 志愿 者 ( 包括 尝试 Pull Request 
的 各 位 读者 ) 进行 维护 。 Eee 出 版 后 ， 随 着 时 间 推 移 ， A A 
慢 甚至 没有 反应 的 情况 。 烦 请 参照 第 7 章 的 内 容 以 及 关于 示例 仓库 的 讲解 ， 
努力 维护 。 
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6.6 Pull Request 





Add my impression #1 


| P1 Open | d-ikeda wants to merge 1 commit into github-book:gh-poges from d-ikeda:work 


M Conversation 2 © Commits 4 [S] Files Changed 司 


" 
gm keda commented 2 months ago 
LI 


Xi Add my impression 


hirooneher commented 15 days ago 


感谢 您 对 Pull Request 进行 实践 。 


Leave a comment 


Attach images by dragging & dropping, selecting them, or pasting from the clipboard. 


E9 ProTip"* Add comments to specific lines under Files Changed. 





Write Preview Comments are parsed with GitHub Flavored Markdown 


None yet 


Milestone 


No milestone 


Assignee 


No one assigned 


Notifications 


G Subscribe 


2 participants 


u 


— 





6.4 让 Pull Request 更 加 有 效 的 方法 


下 面 为 各 位 介绍 在 开发 现场 如 何 更 有 效 地 运 月 








H Pull Request; 


@ 在 开发 过 程 中 发 送 Pull Request 进行 讨论 

在 软件 的 设计 与 实现 过 程 中 如 果 想 发 起 讨论 ，Pull Request 是 个 非常 
好 的 契机 。 我 们 虽然 可 以 像 本 次 示例 一 样 等 代码 完成 后 再 发 送 Pull 
Request， 但 在 实际 开发 过 程 中 ， 这 样 做 很 可 能 导致 一 个 功能 在 完成 后 才 
收 到 设计 或 实现 方面 的 指正 ， 从 而 使 代码 需要 大 幅 更 改 或 重新 实现 。 

















在 GitHub 上 ， 我 们 可 以 尽早 创建 Pull Request, MF 























查 中 获得 反馈 ， 


让 大 家 在 设计 与 实现 方面 思路 一 致 ， 借 此 逐渐 提高 代码 质量 。 这 个 方法 
在 团队 开发 大 型 项 目 时 尤其 有 效 ， 已 将 GitHub 运用 到 实际 开发 中 的 





队 请 务必 试 一 试 。 
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这 个 方法 执行 起 来 很 简单 。 只 要 在 想 发 起 讨论 时 发 送 Pull Request 
即 可 ， 不 必 等 代码 最 终 完成 。 即 便 某 个 功能 尚 在 开发 之 中 ， 只 要 在 Pull 
Request 中 附带 一 段 简单 代码 让 大 家 有 个 大 体 印象 ， 就 能 获取 不 少 反 馈 。 
如 果 在 Pull Request 中 再 加 入 直观 易 懂 的 Tasklist (请 参照 第 5 章 的 

"Tasklist 语法 ”)， 就 能 很 清楚 反映 出 哪些 功能 已 经 实现 ， 将 来 要 做 哪些 
工作 。 这 不 但 能 加 快 审查 者 的 工作 效率 ， 还 能 作为 自己 的 备忘录 使 用 。 

从 反馈 中 ， 我 们 不 但 能 获得 对 自己 所 提议 的 新 功能 的 支持 和 相关 改 
善意 见 ， 有 时 还 会 被 人 指出 自己 没 注意 到 的 失误 ， 或 者 准备 编写 的 代码 
与 其 他 成 员 重复 等 。 这 样 一 来 ,我 们 最 终 所 完成 的 代码 的 质量 一 定 会 比 
原先 高 出 许多 。 

向 发 送 过 Pull Request 的 分 文 添加 提交 时 ， 该 提交 会 自动 添加 至 已 
发 送 的 Pull Request 中 。 

这 一 方法 要 求 尽早 发 送 Pull Request， 越 早 效果 越 明 显 。 另 外 还 有 一 
件 事 要 记 住 ， 就 是 千 万 不 要 在 Pull Request 中 添加 无 关 的 修改 。 处 理 与 主 
题 无 关 的 作业 请 另外 创建 分 支 ， 不 然 会 让 原本 清晰 的 讨论 变 得 一 团 糟 。 



























































e 明确 标 出 “正在 开发 过 程 中 ” 


为 防止 开发 到 一 半 的 Pull Request 被 误 合 并 ， 一 般 都 会 像 图 6.7 中 所 
示 的 那样 在 标题 前 加 上 “[WIP]” 字 样 。WIP 是 Work In Progress 的 简 
写 ， 表 示 仍 在 开发 过 程 中 。 等 所 有 功能 都 实现 之 后 ， 再 消去 这 个 前 绥 。 


6.7 标明 仍 在 开发 中 的 Pull Request 











[WIP] Add feature user manegement #1 "€ 
| 11 Open | hirocaster wants to merge 1 commit into master from 'add-user-manage 
© 
V Conversation 1 © Commits 1 Files Changed 1 3 mum n | 
hirocaster commented 15 da m 
学 ys ago Labels 
None yet 
添加 用 户 的 管理 功能 。 
Milesto 
S 添加 à a bh 
A m 
O 编辑 
p 
[ 
) 删除 Assigne 
的 作业 正在 进行 中 。 No one assigned m 
IE] Add feature user add #1 go;  MotWfications 
4* Unsubscribe 
Add more commits by pushing to the add-user-manage branch on github-book/Images. 
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这 种 在 代码 库 中 边 讨 论 边 开发 的 开发 流程 ， 要 比 以 往 在 完成 之 后 1 
这 个 方法 已 经 被 应 用 到 众多 的 软件 开发 现 
场 。 通 过 这 一 方法 ， 开 发 者 可 以 体验 GitHub 上 独 有 的 速度 感 。 各 位 请 


查 再 反馈 的 流程 高 效 得 多 。 











务必 加 以 实践 。 



































@ 不 进行 Fork 直接 从 分 支 发 送 Pull Request 

这 个 方法 也 值得 在 GitHub 上 进行 开发 的 团队 借鉴 。 

一 般 说 来 ， 在 GitHub 上 修改 对 方 的 代码 时 ， 需 要 先 将 仓库 Fork 到 
本 地 ， 然 后 再 修改 代码 ， 发 送 Pull Request。 但 是 ， 如 果 用 户 对 该 仓库 有 
编辑 权限 ， 则 可 以 直接 创建 分 支 ， 从 分 支 发 送 Pull Request。 利 用 这 一 设 




















计 ， 团 队 开发 时 不 妨 为 每 一 名 成 员 赋予 编辑 权限 ， 免 去 Fork 仓库 的 麻 
烦 。 这 样 ， 成 员 在 有 需要 时 就 可 以 创建 自己 的 分 支 ， 然后 直接 向 master 





分 支 等 发 送 Pull Request; 


其 实 ， 这 一 方法 已 经 被 GitHub 实际 运 


发 流程 的 具体 内 容 将 在 第 











9 章 详细 说 明 。 
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Fork 或 clone 来 的 仓库 ， 


a 3 











j 到 开发 之 中 "“。 关 于 这 一 开 














一 旦 放置 不 管 就 会 离 最 新 的 源 代码 越 来 越 
元 。 如 果 不 以 最 新 的 源 代码 为 基础 进行 开发 ， 劳 神 费 力 地 编写 代码 也 很 

















能 是 白费 力气 。 下 面 就 
通常 来 说 clone 来 的 


























Ei 上 我 们 学 习 如 何 计 


[仓库 保持 最 新 状态 。 























Bu 











仓库 实际 上 与 原 仓库 并 没有 任何 关系 。 所 以 我 








门 需 要 将 原 仓库 设置 为 远程 仓库 ， 从 该 仓库 获取 (fetch) 数据 与 本 地 仓 
FE 进行 合并 (merge )， 让 本 地 仓库 的 源 代码 保持 最 新 状态 ( 图 6.8 )。 


(D https://github.com/blog/1124-how-we-ues-pull-requests-to-build-github 


图 灵 社 区 会 员 


Ixghost2 专 享 尊重 版 权 





65 仓库 的 维护 | 129 


图 6.8 将 仓库 更 新 至 最 新 状态 























Pal octocat/ 
Spoon-Knife Spoon-Knife 


























@ 仓库 的 Fork 5 clone 


将 octocat/Spoon-Knife 作为 原 仓库 ， 在 GitHub 上 进行 Fork， 然 后 
clone。 


$ git clone git@github.com:hirocastest/Spoon-Knife.git 
Cloning into 'Spoon-Knife'... 

remote: Counting objects: 24, done. 

remote: Compressing objects: 100% (21/21), done. 

remote: Total 24 (delta 7), reused 17 (delta 1) 

Receiving objects: 100% (24/24), 74.36 KiB | 68 KiB/s, done. 
Resolving deltas: 100$ (7/7), done. 

$ cd Spoon-Knife 


e 给 原 仓库 设置 名 称 
我 们 给 原 仓 库 设 置 upstream 的 名 称 ， 将 其 作为 远程 仓库 。 


$ git remote add upstream git://github.com/octocat/Spoon-Knife.git 
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今后 ,我们 的 这 个 仓库 将 以 upstream 作为 原 仓库 的 标识 符 。 这 个 环 


A 
境 下 只 需要 设 定 一 次 。 


@ 获取 最 新 数据 


F 面 我 们 从 远程 仓库 实际 获取 (fetch ) 最 新 源 代码 ， 与 自己 仓库 的 
分 文 进 行 合并 。 要 让 仓库 维持 最 新 状态 ， 只 需要 重复 这 一 工作 即 可 。 


$ git fetch upstream 









































From git://github.com/octocat/Spoon-Knife 

* [new branch] master -» upstream/master 
$ git merge upstream/master 
Already up-to-date. 


我 们 通过 git fetch 命令 获取 最 新 的 数据 ， 将 upstream/master 分 
支 与 当前 分 支 (master ) 合并 。 虽 然 本 次 示例 没有 可 以 合并 的 内 容 ， 但 
这 一 操作 确实 可 以 将 最 新 的 源 代 码 合并 至 当前 分 支 。 

这 样 一 来 ， 当 前 分 支 (master) 就 获得 了 最 新 的 源 代 码 。 各 位 在 创 
建 特性 分 支 ， 编 辑 源 代 码 之 前 ， 建 议 先 将 仓库 更 新 到 这 一 状态 。 一 般 情 
况 下 master 分 支 都 会 获取 最 新 代码 ， 很 少 需要 Fork 的 开发 者 亲自 进行 
修正 。 






































6.6 ”小结 





本 章 中 我 们 简单 学 习 了 Pull Request 的 发 送 方法 。 想 必 各 位 已 经 发 
现 ， 发 送 Pull Request 时 不 单 要 项 一 敲 代 人 码 ， 还 需要 进行 很 多 其 他 工作 。 

在 实际 开发 现场 ，Pull Request 多 少 都 会 与 传统 的 习惯 或 规范 有 些 冲 
突 。 但 是 ， 诸 多 团队 的 实践 表明 Pull Request 确实 有 其 显著 的 效果 。 作 
为 一 名 投身 于 开源 开发 的 程序 员 ， 应 当 尽 早 适 应 这 一 设计 。 

笔者 认为 ， 对 这 种 标准 的 设计 或 规范 采取 “总 之 先 试 试 看 ”的 态 
度 ， 往 往 可 以 给 现场 带 来 活力 ， 促 进 成 员 成 长 ， 给 开发 带 来 速度 感 。 建 
议 各 位 积极 地 去 尝试 。 
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发 送 过 Pull Request 的 人 不 多 ， 接 收 过 Pull Request 的 人 就 更 少 了 。 
下 面 让 我 们 来 学 习 接 收 Pull Request 时 的 相关 知识 ， 以 备 不 时 之 需 。 


7.1 采纳 Pull Request 的 方法 


接收 到 Pull Request 后 ,会 如 图 7.1 中 所 示 ， 在 仓库 的 Pull Request 
标签 页 中 显示 别人 发 送 过 来 的 Pull Request 的 一 览 表 。 现 在 让 我 们 点 击 
Pull Request 查看 详细 内 容 。 


7.1 接收 到 的 Pull Request 


Open | Closed Sort: Newest ~ | New pull request | 


11 Fix fail tests #10 
修正 了 未 能 通过 的 测试 。 
» by yuria 10 months ago aV 1 comment 





in Update gems #6 
升级 了 gems 


» by yuria 10 months ago 4f 3 comments 














详细 页 面 与 我 们 发 送 Pull Request 时 的 页 面 大 致 相同 。 点 击 Merge 
pull request 按钮 ( 图 7.2 )，Pull Request 的 内 容 便 会 自动 合并 至 仓库 。 在 
采纳 之 前 ， 请 尽量 将 接收 到 的 Pull Request 拿 到 本 地 开发 环境 中 进行 检 
查 ， 确 认 是 和 否 能 够 正常 运行 以 及 代码 是 否 安全 。 或 者 用 将 要 在 第 8 章 中 
介绍 的 Jenkins 等 持续 集成 工具 进行 自动 测试 ， 保 证 新 代码 不 破坏 原 有 
功能 之 后 ， 再 合并 进 仓库 。 


078 Merge pull request 按钮 





















































M This pull request can be automatically merged. 加 (a 
You can also merge branches on the command line 


这 里 我 们 为 各 位 讲解 在 本 地 开发 环境 中 检查 接收 到 的 Pull Request 
的 流程 。 
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7.2 采纳 Pull Request 前 的 准备 


除 确认 Pull Request 送 来 的 代码 是 否 运行 正常 外 ， 各 位 还 请 在 代码 

用 查 上 也 多 花 些 心思 。GitHub 上 可 以 快速 高 效 地 审查 代码 。 下 面 我 们 就 
来 介绍 这 些 功 能 。 

学 会 使 用 各 种 各 样 的 功能 进行 代码 审查 ， 要 比 以 往 使 用 工具 的 审查 

轻松 很 多 。 如 果 团 队 中 所 有 人 都 养 成 时 常 审查 自己 代码 的 习惯 ， 其 释 加 

效果 将 不 可 估量 。 


m 

































































e 代码 审查 


如 图 7.3 所 示 , 在 GitHub 上 可 以 对 Pull Request 的 具体 的 某 行 代码 
进行 评论 。 这 让 代码 审查 变 得 十 分 高 效 。 
图 7.3 ”对 代码 进行 评论 








V9 Conversation ^1 © Commits 可 国 Files Changed 1 2 um 
司 Showing 1 changed file with 2 additions and 0 deletions. Show Diff Stats 
2mm index.html @ show inline notes [@ Open View 


ee -39,6 +39,8 68 <h2 id="project_tagline">WEB+DB PRESS Vol.69 Github 特 集 </h2> 
«p» 请 写 明 这 是 对 本 书 内 容 的 实践 或 描述 对 本 书 的 感想 并 发 送 Pull Requesto </p> 
*«p class="impression"> 这 本 书 读 着 很 有 趣 。(&HIROCASTER) </p> 
p: [E] hirocaster added a note 2 years ago EX P) 


感谢 您 的 购买 及 阅读 。 
Add a line note 
+ 
«p class="impression"> 我 早 就 知道 有 Github 这 个 东西 ， 但 从 没 积极 地 去 用 过 ， 周 围 也 没 人 能 给 我 讲 怎么 用 。 


<h3> 咨询 </h3> 











K 每 行 前 左 侧 的 数字 为 该 提交 修改 前 的 行 号 ， 右 侧 为 修改 后 的 行 号 。 

发 出 评论 之 后 相关 人 员 会 立刻 接 到 Notifications， 无 论 是 Pull 
Request 的 发 送 方 还 是 接收 方 ， 都 能 迅速 反馈 。 由 于 GitHub 的 便捷 性 和 
审查 的 简易 性 ， 让 很 多 人 离开 GitHub 之 后 在 工作 中 倍 感 压力 。 

混迹 于 开源 世界 的 程序 员 大 多 习惯 使 用 GitHub， 所 以 如 果 能 将 
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GitHub 应 用 到 工作 中 ， 就 可 以 免 去 适应 公司 独 有 开发 环境 带 来 的 压力 。 
这 也 是 公司 导入 GitHub 的 优势 所 在 。 








@ 查看 图 片 的 差别 


在 GitHub 上 不 但 可 以 查看 代码 的 差别 ， 还 有 多 种 方法 供用 户 查 看 
图 片 的 差别 。 这 些 内 容 在 官方 博客 ”中 有 详细 讲解 ， 我 们 只 在 此 挑 出 一 
些 介绍 给 各 位 。 
吉方 博客 已 经 介绍 了 用 于 演示 的 仓库 ”, 所 以 各 位 实际 操作 一 下 该 仓 
库 ， 就 会 发 现 这 个 功能 有 多 么 强大 “。 各 位 可 以 通过 提交 日 志 的 Image 
View Mode Demo 来 体验 操作 。 









































e 2-up 


2-up 可 以 同时 显示 一 张 旧 图 片 和 一 张 新 图 片 ， 从 而 完成 对 比 
(图 7.4)。 





7.4 2-up 
BIN BEEEE 1_normal . jpg View file @ 8e95£70 




















W: 300px I H: 300px W: 300px I H: 300px 





2-up Swipe Onion Skin Difference 








(D https://github.com/blog/817-behold-image-view-modes 
Q) https;//github.com/cameronmcefee/Image-Diff-View-Modes 
© 本章 的 图 片 就 是 通过 演示 仓库 制作 的 。 
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Swipe 可 以 在 分 界线 左右 两 侧 分 别 显示 旧 图 片 和 新 图 片 (图 7.5 )。 鼠 
标 可 以 拖 动 分 界线 左右 移动 ， 帮 助 用 户 对 比 细 节 差 异 和 细微 的 颜色 差异 。 











图 7.5 Swipe 





BINENSEEN 2 transparentPixels.png View file & 8e95£70 

















2-up | Swipe | OnionSkin | Difference 





e Onion Skin 














Onion Skin 能 够 将 新 旧 两 张 图 片 重合 放置 ,分 阶段 从 旧 图 片 慢 慢 过 
渡 至 新 图 片 ， 用 户 可 以 自由 调节 过 渡 比 例 (图 7.6 ),。 通过 这 一 功能 ， 用 
户 能 够 一 步 步 确 认 新 图 片 相对 于 旧 图 片 的 变化 。 





























图 7.6 Onion Skin 





BINESEEEE 3 tooLarge.jpg View file @ 8e95£70 


THIS OCTOCAT IS BALLIN' OUT OF CONTROL 


de) 


(also; thisimage is 1000px wid 
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e@…… Difference" 

Difference 功能 让 笔者 都 感到 吃惊 ， 它 能 够 直接 抽出 两 张 图 片 不 一 
样 的 部 分 进行 比较 。 如 图 7.7 所 示 ，Difference 抽出 了 单 片 眼镜 这 一 差别 
之 处 。 要 是 拿 这 个 功能 去 玩 “ 大 家 来 找茬 "， 一 定 是 所 向 披 靡 。 





























图 7.7 Difference 





BIN 1.normal.jpg View file @ 8e95£70 





2-up Swipe Onion Skin Difference 














像 这 样 ， 使 用 GitHub 不 但 可 以 比较 代码 ， 还 能 够 高 效 地 对 比 图 片 。 
各 位 不 妨 让 负责 美工 的 同事 也 来 试 试 。 

















@ 在 本 地 开发 环境 中 反映 Pull Request 的 内 容 

下 面 我 们 来 讲解 收 到 Pull Request 后 在 本 地 开发 环境 中 进行 实际 检 
查 的 流程 。 在 本 示例 中 ，Pull Request 接收 方 的 用 户 名 为 ituring， 发 送 方 
的 用 户 名 为 “PR 发 送 者 ”。 
































o- 将 接收 方 的 本 地 仓库 更 新 至 最 新 状态 


首先 ， 将 Pull Request 接收 方 的 仓库 clone 到 本 地 开发 环境 中 (图 
7.8 左 侧 )。 如 果 已 经 clone 过 ， 那 么 请 进行 pull 等 操作 更 新 至 最 新 状态 。 

















(D 现在 只 有 前 面 三 种 差分 模式 ， 此 种 方式 已 经 没有 了 。 





译 者 注 
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图 7.8 clone 及 fetch 








PR ar E C am S SN 
接收 者 PR 发 送 者 


ituring PR 发 送 者 








$ git clone gitGgithub.com:ituring/first-pr.git 

Clondng into Tirot = pr 

remote: Counting objects: 34, done. 

remote: Compressing objects: 100% (26/26), done. 

remote: Total 34 (delta 10), reused 15 (delta 4) 

Receiving objects: 100% (34/34), 89.48 KiB | 112 KiB/s, done. 
Resolving deltas: 100% (10/10), done. 

$ cd first-pr 


@…… 获取 发 送 方 的 远程 仓库 

将 Pull Request 发 送 方 的 仓库 设置 为 本 地 仓库 的 远程 仓库 ， 获 取 发 
送 方 仓库 的 数据 。 在 本 示例 中 ， 我 们 将 图 7.8 右上 的 仓库 设置 为 远程 仓 
库 ， 进 行 fetch. 


$ git remote add PR 发 送 者 git@github.com:PR 发 送 者 /first-pr.git 
$ git fetch PR 发 送 者 














省 略 

From github.com:PR 发 送 者 /first-pr 

* [new branch] gh-pages -> PR 发 送 者 /gh-pages 
* [new branch] master -» PR 发 送 者 /master 

* [new branch] work -> PR 发 送 者 /work 
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现在 我 们 获取 了 Pull Request 发 送 方 仓库 以 及 分 支 的 数据 ( PR 发 送 
者 /work )。 





e- 创建 用 于 检查 的 分 支 


前 面 我 们 只 获取 了 远程 仓库 的 数据 ， 这 些 数据 尚未 反映 在 任何 一 个 
分 支 中 。 因 此 我 们 需要 创建 一 个 分 支 ， 用 来 模拟 采纳 Pull Request 后 的 
状态 。 由 于 这 是 我 们 第 一 个 Pull Request, 分支 名 就 叫 prl。 这 一 步 相当 
于 图 7.9 左 侧 箭头 〈checkout ) 代表 的 操作 。 现 在 gh-pages 与 prl 分 支 
的 内 容 完 全 相同 。 


7.9 checkout 











fetch 
~ m ~ 
PR 发 送 者 / 

merge 











$ git checkout -b pri 


Switched to a new branch 'prl' 


下 面 要 将 已 经 fetch 完毕 的 “PR 发 送 者 /work” 的 修改 内 容 与 prl 
分 支 进行 合并 。 也 就 是 图 7.9 下 侧 箭头 〈merge ) 代表 的 操作 。 


$ git merge PR 发 送 者 /work 
Updating cc62779..243f28d 
Fast-forward 








index.html | 2 ++ 
1 file changed, 2 insertions (+) 


这 样 一 来 ，prl 分 文中 就 加 入 了 “PR 发 送 者 /work” 分 文 的 修改 内 
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容 。 本 示例 中 我 们 只 修改 了 index.html 文件 ， 所 以 检查 一 下 index.html 
有 没有 显示 错误 即 可 。 在 实际 开发 中 ， 各 位 需要 通过 自动 测试 等 手段 检 
查 软 件 是 否 能 正常 运行 。 





























检查 结束 后 prl 分 支 就 没 用 了 ， 可 以 直接 删除 。 我 们 切换 至 prl 之 
外 的 分 支 ， 运行 下 面 的 代码 。 


$ git branch -D pri 
Deleted branch prl (was 243f28d). 























专栏 : 如 何 提升 代码 管理 技术 


如 果 能 灵活 运用 分 支 的 创建 及 合并 ， 便 可 以 在 确保 安全 性 的 
前 提 下 并 行 开 发 多 个 功能 。 这 一 技术 在 软件 开发 现场 非常 ; 
而 且 团 队 规模 越 大 效果 越 好 。 
笔者 认为 掌握 这 一 技术 的 最 佳 方法 就 是 积累 经 验 。 在 GitHub 
上 ， 可 以 通过 自己 给 自己 的 不 同 分 支 发 送 Pull Request 进行 练习 。 
想 学 会 安全 又 专业 的 源 代码 管理 ， 不 妨 先 多 多 尝试 Git 与 
GitHub。 














































































































































































































7.3 采纳 Pull Request 


完成 上 述 内 容 后 ， 如 果 Pull Request 的 内 容 没 有 问题 ， 大 可 打开 浏 
V asd HH] Pull Request 页 面 ， 点 击 Merge pull request 按钮 ， 随 后 
Pull Request 的 内 容 会 自动 合并 至 仓库 ( 图 7.10 )。 

不 过 ， 由 于 我 们 已 经 在 本 地 构筑 了 相同 的 环境 ， 只 要 通过 CLI 进行 
合并 操作 再 push 至 GitHub，Pull Request 中 就 会 反映 出 Pull Request 被 
采纳 后 的 状态 (图 7.11 )。 这 个 状态 对 应 到 本 示例 中 就 是 “PR 发 送 者 / 
work” 分 支 合并 到 gh-pages 分 支 。 
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7.10 ”自动 合并 的 概念 图 





GitHub 


C Jam auto merge (C P 
ms 


git git 
4- 一 
PR 








7.11 “ 手动 合并 的 概念 图 





push 














e 合并 到 主 分 支 
首先 ， 我 们 切换 至 gh-pages 分 支 。 


$ git checkout gh-pages 
Switched to branch 'gh-pages' 


然后 合并 “PR 发 送 者 /work” 分 支 的 内 容 。 


$ git merge PR 送信 者 /work 
Updating cc62779..243f28d 


Fast-forward 





index.html | 2 ++ 
1 file changed, 2 insertions (+) 
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这 样 一 来 “PR 发 送 者 /work” 分 支 就 合并 到 了 gh-pages 分 支 中 。 


@ push 修改 内 容 


MERR F push 一 步 了 ， 不 过 为 保险 起 见 ， 我 们 先 查 看 本 地 与 
GitHub 端 仓库 内 代码 的 差别 。 


$ git diff origin/gh-pages 

diff --git a/index.html b/index.html 
index f£2034b3..91b8ecb 100644 

--- a/index.html 

+++ b/index.html 

@@ -39,6 439,8 @@ 





<p> 请 写 明 这 是 对 本 书 的 实践 或 描述 对 本 书 的 感想 并 发 送 Pull Requesto </p> 














+<p class="impression"> 这 本 书 读 着 很 有 趣 。 ( @HIROCASTER ) </p> 
省 略 
X » Eh 

确认 没有 目的 之 外 的 差别 后 ， 进 行 push。 
$ git push 
省 略 
Total 0 (delta 0), reused 0 (delta 0) 
To gitGgithub.com:ituring/first-pr.git 

CC62779..243f28d 1local gh-pages -» gh-pages 


这 种 方法 处 理 后 ， 仓 库 的 Pull Request 会 自动 从 Open 状态 变 为 
Close 状态 (图 7.12 )。 现 在 我 们 可 以 去 查看 网 页 ， 已 采纳 的 源 代码 应 该 
已 经 反映 出 来 了 。 


图 7.12 Pull Request 自动 转 为 Close 状态 























Q (E hirocaster merged commit 243f28d into gh-pages from work 2 years ago 


Ó mq hirocaster closed the pull request 2 years ago 











以 上 便 是 安全 接收 Pull Request 的 流程 。Git 这 种 分 散 型 版 本 管理 软 
件 乍 看 上 去 非常 复杂 ， 但 熟悉 每 一 个 操作 后 ， 运 用 起 来 还 是 很 简单 的 。 
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7.4 小 结 





本 章 中 我 们 讲解 了 如 何 安全 地 接收 Pull Request. 








像 本 次 示例 中 这 种 只 有 几 行 代码 的 Pull Request， 大 可 直接 打开 
GitHub 网 页 点 击 合并 ， 但 在 实际 的 开发 现场 中 ， 接 收 到 的 Pull Request 


























只 是 为 练习 而 准备 ， 是 Pull Request 最 简单 的 情况 。 





作为 仓库 的 维护 者 要 时 刻 记得 ， 无 法 运行 的 代码 绝 不 可 以 合 人 





库 ， 和 否则 会 失去 团队 对 你 的 信任 。 








往往 会 更 加 复杂 ， 有 时 甚至 与 多 个 文件 挂钩 。 所 以 各 位 要 清楚 本 次 示例 


[9> 





另外 还 要 注意 ， 不 要 发 布 那 些 无 法 运行 的 、 没 有 通过 测试 的 、 有 语 


法 错误 的 源 代码 。 


专栏 : 请 协助 我 们 共同 创建 互相 学 习 的 社区 


LS NS 














关于 本 章 和 第 6 章 提 到 的 那个 仓库 ， 只 要 您 在 第 63 
过 Pull Request， 就 会 得 到 该 仓库 的 管理 权限 ， 以 便 您 对 


















































rH pras 
该 仓库 





















































进行 维护 。 各 位 可 以 参考 本 章 内容 ， 试 着 以 仓库 维护 者 的 身份 处 














理 新 送 来 的 Pull Request。 这 样 一 来 ， 各 位 读者 就 可 以 通 
人 仓库， 互相 学 习 Pull Request 收发 双方 的 相关 知识 。 





















































过 一 个 
各 位 读者 的 协助 不 但 能 帮助 新 的 读者 进行 学 习 ， 还 可 以 积累 
学 习 的 





























作为 维护 方 的 经 验 。 请 各 位 务必 与 我 们 一 同 维护 这 个 互相 
社区 。 
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GitHub 的 诞生 并 不 单单 影响 到 了 软件 开发 的 相关 人 员 。 现 在 的 
GitHub 已 经 真正 成 为 了 一 个 Hub， 与 其 相互 协作 的 工具 和 服务 层 出 不 
穷 。 下 面 让 我 们 为 各 位 介绍 几 个 比较 常用 的 服务 。 




















8.1 hub 命令 











在 使 用 GitHub 的 过 程 中 ， 会 不 可 避免 地 频繁 接触 到 git 命令 。 而 我 
门 在 这 里 介绍 的 hub 命令 ” 则 是 一 个 封装 了 git 命令 的 命令 行 工 具 , 能 够 
辅助 用 户 使 用 GitHub。 这 是 个 很 方便 的 工具 ， 经常 使 用 GitHub 的 读者 
请 务必 一 试 。 














- 























e 概要 

hub 命令 是 由 Chris Wanstrath2 带头 开发 的 软件 。 

在 hub 命令 仓库 的 README.md 文件 中 ， 我 们 可 以 看 到 “git + hub 
= github” 这样 一 句 话 ”“。 正 如 这 名 话 所 说 , hub 命令 将 通常 的 git 命令 进 
行 封装 并 增加 几 项 功能 ， 就 可 以 调用 GitHub 的 API 发 送 命令 。 由 于 其 
封装 了 git 命令 ， 所 以 能 够 执行 所 有 git 命令 的 操作 。 另 外 通过 hub 命令 
功能 还 得 到 了 扩展 ， 比 如 指定 GitHub 端 仓 库 时 可 以 用 简略 路 径 蔡 代 完 
整 路 径 等 。 
具体 的 命令 我 们 将 在 后 面 详细 讲解 。 




































































下 面 介 绍 hub 命令 的 安装 方法 。hub 命令 需要 以 下 版 本 的 软件 ”。 














https://hub.github.com/ 
https://github.com/defunkt 
https://github.com/github/hub 
对 应 hub 1.10.6 版 本 。 


e e iGo 
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e Git 1.7.3 以 上 
* Ruby 1.8.6 以 上 





如 果 是 OS X 系统 ， 可 以 从 版 本 管理 系统 的 Homebrew 2X MacPorts 
轻松 安装 。 
如 果 用 Homebrew, Jd fT F If 


$ brew install hub 


如 果 用 MacPorts， 则 执行 下 面 的 命令 。 
$ sudo port install hub 
只 此 一 步 就 能 完成 安装 。 
使 用 其 他 环境 的 读者 请 按照 下 面 的 流程 安装 。 


$ curl https://hub.github.com/standalone -sLo -/bin/hub 
$ chmod «x -/bin/hub 























到 
æ 
AP 





























通过 上 述 命令 下 载 hub 命令 之 后 ， 像 下 面 这 样 在 shell 的 环境 路 径 
后 面 添加 ~/bin。 


$ echo 'export PATH-"-/bin:$PATH"' >> -/.bash profile 

















重新 启动 shell 后 ， 就 可 以 使 用 hub 命令 了 。 








e 确认 运行 情况 
通过 下 面 的 命令 确认 运行 情况 。 


$ hub --version 











git version 1.8.5.2 





hub version 1.10.6 


结果 中 显示 了 git 命令 与 hub 命令 的 版 本 号 。 























©- 设置 别名 


使 用 hub 命令 的 最 佳 实践 就 是 将 相应 git 设置 成 hub 的 别名 。hub 命 
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令 可 以 完成 git 命令 的 所 有 操作 ， 所 以 不 会 影响 git 命令 原本 的 功能 。 
具体 设置 方法 其 实 很 简单 ， 只 需 在 shell 的 配置 文件 ( .bash_profile 
等 ) 中 添加 下 面 一 句 即 可 。 


eval "$(hub alias -s)" 





























@…… 实 现 shell 上 的 功能 补 全 


为 了 让 hub 命令 的 功能 更 加 完善 ，Github 上 还 发 布 了 面向 bash” 4 
zsh? 的 脚本 。 将 正在 使 用 的 shell 与 相应 脚本 组 合 , 就 可 以 让 hub 命令 变 
得 更 加 易 用 。 在 某 些 安装 方法 中 它们 会 被 自动 安装 。 












































e -J.config/hub 

hub 命令 在 初次 访问 GitHub 的 API 时 会 询问 用 户 名 和 密码 ， 输 入 完 
之 后 会 进行 OAuth 认证 ， 然 后 我 们 就 可 以 通过 API 操 作 GitHub 了 。 这 时 
OAuth Token 会 自动 保存 在 ~/.config/hub 中 。 各 位 请 慎重 保管 这 个 Token, 








github.com: 


- oauth token: 


user: hirocaster 








e 命令 
下 面 我 们 来 实际 使 用 hub 命令 ， 看 看 它 为 Git 扩展 了 哪些 功能 。 

















为 了 与 git 命令 区 分 得 更 明显 ， 接 下 来 讲解 的 内 容 中 我 们 都 直接 输入 
hub 命令 。 已 经 将 git 命令 设置 为 别名 的 读者 可 以 把 hub 的 部 分 替换 为 
git， 运 行 效果 是 一 样 的。 当然 ， 直 接 输入 hub 命令 也 不 会 有 任何 问题 。 

















e hub clone 





使 用 hub clone 命 令 ， 可 以 省 去 指定 GitHub 端 仓 库 的 部 分 。 


$ hub clone Hello-World 








(D https://github.com/defunkt/hub/blob/master/etc/hub.bash completion.sh 
Q) https;//github.com/defunkt/hub/blob/master/etc/hub.zsh completion 
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上 面 这 个 命令 与 下 面 的 命令 效果 相同 。 


$ git clone git@github.com/ 用 户 名 /Hello-World.git 
























































如 果 要 指定 用 户 ， 可 以 输入 以 下 命令 。 


$ hub clone octocat/Hello-World 


效果 与 下 面 这 个 命令 完全 相同 。 


$ git clone git://github.com/octocat/Hello-World.git 























e hub remote add 


hub remote adqq 也 可 以 省 略 指定 GitHub 端 仓库 的 部 分 。 


$ hub remote add octocat 


上 面 这 个 命令 与 














$ git remote add octocat git://github.com/octocat/ 当 前 操作 仓库 的 名 称 .git 
的 效果 完全 相同 。 
e hub fetch 


hub fetch5 hub remote add 命令 一 样 ， 只 需 输入 用 户 名 就 
可 以 指定 当前 操作 的 仓库 执行 命令 ， 在 此 不 再 歼 述 。 





9e hub cherry-pick 


hub cherry-pick 命 令 只 需要 输入 URL 就 可 以 获取 对 应 修改 并 
应 用 到 当前 分 支 。 在 审查 代码 时 ， 如 果 发 现 某 个 提交 中 包含 值得 应 用 到 
当前 分 支 的 修改 ， 用 这 个 命令 可 以 轻松 完成 操作 。 


$ hub cherry-pick https://github.com/hirocaster/github-book/commit/606a 
76£6831194cfe8a0fdcd6e974a29a4526cbf ”实际 为 1 行 


这 个 命令 可 以 将 下 面 两 个 命令 的 效果 一 次 性 执行 。 


$ git remote add -f hirocaster git://github.com/hirocaster/github-book.git 
$ git cherry-pick 606a76f6831194cfe8a0fdcd6e974a29a4526cbf 
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e hub fork 





hub fork 命 令 的 功能 与 GitHub 页 面 的 Fork 按钮 相同 。 比 如 我 们 
clone 了 其 他 用 户 的 仓库 ， 现 在 想 Fork 成 自己 的 仓库 ， 只 需要 执行 


$ hub fork 
这 一 命令 ， 就 可 获得 与 下 面 这 一 系列 操作 相同 的 效果 。 


( 在 GitHub 上 对 仓库 做 Fork 处 理 ) 
$ git remote add -f P git@github.com: 当前 操作 仓库 的 名 称 .git 


执行 完毕 后 ，Fork 出 的 仓库 会 被 设置 成 当前 本 地 仓库 的 远程 
(以 用 户 名 为 标识 符 )。 





























c 
JE 























e hub pull-request 


hub pull-request 命 令 为 我 们 提供 了 创建 Pull Request 的 功能 。 
利用 这 个 命令 创建 Pull Request 可 以 不 必 访 问 GitHub 页 面 。 


$ hub pull-request -b github-book:master -h hirocaster:index5-draft 


使 用 这 条 命令 ， 可 以 从 hirocaster 的 index5-draft 4) 3c [n] github-book 
的 master 分 支 发 送 Pull Request。 执 行 命令 后 编辑 髓 会 启动 ， 用 户 可 以 
在 编辑 器 中 按照 一 般 Pull Request 的 方式 进行 描述 。 第 一 行将 成 为 Pull 
Request 的 标题 ， 之 后 空 一 行 ， 从 第 三 行 开 始 是 Pull Request 的 正文 。 
如 果 index5-draft 的 作业 内 容 是 已 创建 的 Issue#123 的 作业 内 容 ， 我 
们 可 以 直接 将 Issue 作为 Pull Request 发 送 。 


$ hub pull-request -i 123 -b github-book:master -h hirocaster:index5-draft 


只 需 附 加 参数 -i 以 及 Issue 的 编号 即 可 。 目 前 在 Web 上 无 法 像 这 样 
将 Issue 直接 作为 Pull Request 发 送 ， 所 以 建议 各 位 开发 者 记 下 这 个 技巧 。 
































I 





























e hub checkout 


收 到 Pull Request 的 时 候 ， 如 果 想 在 本 地 检查 该 分 支 的 运行 状况 ， 
可 以 使 用 hup checkout 命 令 。 只 需要 在 命令 后 添加 相应 Pull Request 
的 URL， 就 可 以 将 接收 到 的 分 支 checkout; 
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$ hub checkout https://github.com/hirocaster/wdpress69/pull/208 


这 个 命令 与 下 面 两 个 命令 效果 相同 。 


$ git remote add -f -t impression git://github.com/tomamu/wdpress69.git 
$ git checkout --track -B tomamu-impression tomamu/impression 














执行 之 后 系统 会 以 “Pull Request 发 送 方 的 用 户 名 - 分 支 名 ” bici 
在 本 地 仓库 中 创建 分 支 。Pull Request 送 来 的 内 容 已 经 checkout 完毕 
管理 者 可 以 轻松 地 检查 运行 状况 。 





e hub create 


hub create 命令 适用 于 本 地 已 经 创建 仓库 ， 但 GitHub 端 没 有 创 
建仓 库 的 情况 。 


$ hub create 


只 需要 输入 上 面 这 个 简短 的 命令 ，GitHub 端 就 会 创建 一 个 同名 仓 
库 ， 并 将 其 设置 为 本 地 仓库 的 远程 仓库 。 这 与 下 面 这 一 系列 操作 效果 
相同 。 


( 在 GitHub 上 创建 仓库 ) 
$ git remote add origin git@github.com: 用 户 名 /当前 操作 仓库 的 名 称 .git 


















































现在 只 要 进行 push， 代 码 就 可 以 放 到 GitHub 端的 仓库 中 。 需 要 注 
意 的 是 ， 这 种 方法 创建 的 都 是 公开 仓库 ， 请 谨慎 使 用 。 











e hub push 


hub push 命 令 支持 同时 向 多 个 远程 仓库 进行 push 操作 。 


$ hub push origin,staging,qa new-feature 





这 一 命令 可 以 对 下 列 远 程 仓 库 同时 执行 git push 命 令 。 
* origin 


e staging 


e qa 
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如 果 遇 到 需要 向 多 个 仓库 进行 push 操作 的 情况 ， 各 位 不 妨 试 一 试 。 














e hub browse 
hub browse 命 令 可 以 在 浏览 器 中 打开 当前 操作 的 仓库 在 GitHub 
上 对 应 的 仓库 页 面 。 
$ hub browse 
这 个 命令 与 下 面 的 效果 相同 。 
$ open https://github.com/ 用 户 名 /当前 操作 仓库 的 名 称 


执行 后 ， 当 前 操作 仓库 的 页 面 会 在 浏览 器 中 打开 。 


















































e hub compare 











如 果 想 查看 当前 特性 分 支 与 master 分 支 的 差别 ， 可 以 使 用 hub 
compare 命令 。 这 个 命令 能 够 打开 GitHub 上 对 应 的 查看 差别 的 页 国 
在 特性 分 支 下 执行 下 面 的 命令 。 
$ hub compare 
其 效果 与 执行 下 面 命令 的 效果 相同 。 
$ open https://github.com/ 用 户 名 /当前 操作 仓库 的 名 称 /compare/ 当 前 分 支 名 
执行 后 ，GitHub 上 查看 分 支 间 差 别 的 页 面 就 会 打开 。 需 要 注意 的 
， 这 种 方法 是 查看 GitHub 端 仓库 内 的 差别 ， 如 果 最 新 代码 在 本 地 仓 
需要 先 将 分 支 push 给 远程 仓库 。 

















o 




































































s 











现在 各 位 应 该 明白 ， 导 入 hub 命令 可 以 使 熟悉 命令 行 操作 的 开发 者 
对 GitHub 更 加 得 心 应 手 。 我 们 只 介绍 了 使 用 频率 较 高 的 一 些 命令 ， 其 
实 hub 命令 并 不 止 这 些 。 
$ hub help 
执行 上 面 的 命令 ， 可 以 查看 hub 命令 的 相关 帮助 。 里 面 介绍 了 添加 
参数 后 更 加 细致 的 操作 ， 各 位 不 妨 去 看 一 看 。 
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专栏 : 让 GitHub Enterprise 支 持 hub 命 令 


hub 命令 不 但 可 以 用 于 GitHub， 还 可 以 用 于 GitHub Enterprise 
的 操作 。 使 用 GitHub Enterprise 的 读者 请 运行 下 面 的 命令 。 






























































$ git config --global --add hub.host my.example.org 


X 请 将 my.example.org 替换 成 GitHub Enterprise 的 主机 名 











~/.gitconfig 文件 中 就 会 添加 下 面 这 条 设置 。 


[hub] 
host - my.example.org 














添加 这 条 设置 后 ， 从 GitHub Enterprise 上 clone 来 的 仓库 
会 以 GitHub Enterprise 为 对 象 执行 hub 命令 ， 而 从 GitHub 上 
clone 来 的 仓库 仍 和 原来 一 样 ， 以 GitHub 为 对 象 执行 操作 。 




















8.2 Travis CI 


e 概要 


Travis CT 是 一 款 免 费 服务 ， 专 门 托管 面向 开源 开发 组 织 的 CI 
( Continuous Integration ， 持 续集 成 )。 

CI 是 XP (Extreme Programming， 极 限 编程 ) 的 实践 之 一 。 近 年 来 
人 们 普遍 使 用 Jenkins 等 软件 来 实现 这 一 目的 。 

让 CI 软件 监视 仓库 ， 可 以 在 开发 者 发 送 提交 后 立刻 执行 自动 测试 
或 构建 。 通 过 持续 执行 这 样 一 个 操作 ， 可 以 检测 出 开发 者 意外 发 送 的 提 
交 或 无 意 的 逻辑 偏差 ， 让 代码 保持 在 一 定 质量 以 上 。 

如 果 各 位 正在 通过 GitHub 发 布 代 码 ， 建 议 使 用 Travis Cl. Travis CI 
支持 Ruby、PHP Perl, Python, Java, JavaScript 等 Web 相关 的 语言 “。 







































































(D http://travis-ci.org/ 
Q) http://about.travis-ci.org/docs 


图 灵 社 区 会 员 lxghost2 专 享 尊重 版 权 





152 | 第 8 章 与 GitHub 相互 协作 的 工具 及 服务 





e 实际 尝试 


现在 让 我 们 来 设置 自己 的 仓库 ， 让 它 可 以 使 用 Travis CI。 一 般 情况 
下 ， 只 要 在 仓库 中 添加 .travis.yml 这 样 一 个 Travis CI 专用 的 文件 ， 
Travis CI 就 与 GitHub 集成 了 。 


























e 编写 配置 文件 
我 们 以 在 Ruby on Rails 上 应 用 RSpec 为 例 ， 编 写 .travis.yml 文件 。 


language: ruby 
rvm: 

2 28.2 

s e 


Script: bundle exec rspec spec 


如 上 所 述 ， 按 照 


。 所 使 用 语言 
。 版 本 
。 执行 测试 的 相关 命令 





的 顺序 描述 。 如 果 一 次 描述 多 个 版 本 ， 则 会 以 每 个 版 本 分 别 进行 测 
iX. 这样 一 来 ， 用 户 可 以 迅速 检测 出 代码 在 哪些 版 本 下 无 法 通过 测试 。 

如 果 各 位 使 用 其 他 种 类 的 语言 ,请 参考 官方 网 站 的 相关 文档 "“。 基 本 
的 设置 方法 不 变 。 将 这 个 文件 放置 到 仓库 的 路 径 下 再 push 给 GitHub 
端 ， 我 们 就 基本 完成 了 使 用 Travis CI 的 准备 工作 。 


















































e- 检测 配置 文件 是 否 有 问题 

Travis CI 专门 提供 了 Travis WebLint 供用 户 检测 ‘travis.yml 文件 是 
否 存 在 问题 >。 检测 时 只 需 指定 仓库 ， 如 果 发 现 问题 会 出 现 图 8.1 中 的 
页 面 。 











(D http://about.travis-ci.org/docs/user/getting-started/ 
@ http://lint.travis-ci.org/ 
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FE] 8.1 通过 Travis WebLint 检测 配置 是 否 正常 


Travis WebLint 


Uses travis-lint to check your .travis.yml config. 

















如 果 配 置 文件 的 描述 有 误 ， 在 实际 启动 CI 后 会 返回 错误 结果 ， 但 
此 时 人 们 往往 摘 不 清 问题 出 在 哪里 。 所 以 在 开始 使 用 CI 之 前 请 务必 进 
行 这 项 检测 。 

















@…… 与 GitHub 集成 


现在 让 我 们 访问 Travis CI 的 网 站 ， 点 击 右 上 角 的 Sign in with 
GitHub, {A GitHub 的 用 户 名 与 密码 后 ， 会 通过 GitHub 进行 认证 。 认 
证 完毕 再 回 到 这 个 页 面 ， 之 前 显示 Sign in with GitHub 的 地 方 就 变 成 了 
] 户 的 GitHub 信息 。 
现在 我 们 把 鼠标 指针 移动 到 头像 上 ， 点 击 Accounts 跳 转 至 图 8.2 所 
示 的 页 面 。 页 面 下 部 是 我 们 的 仓库 列表 。 我 们 只 要 将 仓库 名 右 侧 的 开关 
置 为 ON， 就 可 以 对 该 仓库 应 用 Travis CI. 












































图 8.2 Accounts 


Status — Help Travis CI for Private Repositories (B4. Hiro OHTSUKA 
Hiroki OHTSUKA "es 
Please read our guide. It will 
Repositories Profile 


only take a few minutes :) 


Flick the switches below to turn on the Travis service hook for your projects, then push to GitHub. You can find detailed docs 


on our about site. 





Last synchronized from GitHub: about 7 hours ago Sync now If you need help please 
don't hesitate to join &travis 
on irc.freenode.net or our 


hirocaster/anemone + OFF mailing list. 
hirocaster/blog + orr 
hirocaster/bootstrap * OFF 
hirocaster/boxen * OFF 











访问 GitHub 的 Webhooks & Services 页 面 (图 8.3 )， 点 击 Configure 
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A 


services 后 从 列表 中 选择 Travis， 我 们 就 能 看 到 Travis 的 设置 了 。 点 击 
Test Hook 按钮 ，Travis CI 端 会 对 这 个 仓库 进行 试验 性 的 自动 测试 。 现 
在 我 们 再 回 到 Travis CI， 查 看 自动 测试 是 否 正常 执行 。 如 果 所 执行 内 容 
与 我 们 设置 的 相同 ， 那 么 这 次 设置 就 算 完成 了 。 

今后 ， 向 GitHub 的 push 操作 将 会 自动 触发 Travis CI 端的 自动 
测试 。 














8.3 “Hook 的 测试 








Options Webhooks Add webhook 
e 
Collaborators Webhooks allow external services to be notified when certain events happen on GitHub. When the specified 
events happen, well send a POST request to each of the URLs you provide. Learn more in our Webhooks Guide. n 
Webhooks & Services 
国 
Deploy Keys 
We also support integrations with third-party services. Looking for those? 
P 
ET 
Services User 
ActiveCollab hirocester P 
Acunote Token 
AglieBench x 
agez LLÜÓBRL——2Z 
AmazonSNS Domain 
Aplary 
Apolo 
AppHarbor @ Active. 
Apropos 
Asana 
TestHook Update settings 
AWS OpsWorks 








这 个 仓库 在 Travis CI Jm URL X https://travis-ci.org/ 
用 户 名 / 仓库 名 。 用 户 可 以 在 这 个 页 面 查 看 自动 测试 的 执行 情况 。 另 
外 ， 跳 转 至 Travis CI 首页 直接 搜索 自己 的 用 户 名 等 信息 ， 也 可 以 查询 到 
测试 的 执行 情况 ( 图 8.4 ). 


图 8.4 ”测试 的 执行 情况 


























hirocaster/HelloTravis p hirocaster/HelloTravis © 
Mp Senrch Current Bud History  PulRequess Branch Summary e 
 hirocaster/HelloTravis 3 Build o3 Comm utbs faster! 
Taasen State Passed Compare  fa8ee919b3b8. 232fsb5d4874 
T 3monthsago Finished 3months ago Author hirocaster 
Duration 1min 56sec Committer hirocaster 
Message Add Travis-Cl result image 
Build Matrix 
Job Duration Finished Rum 
631 50sec 3monthsago 192 
0632 lmin6sec 3monthsago 193 
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在 .travis.yml 中 写 入 设置 ， 还 可 以 通过 邮件 或 IRC (Internet Relay 
Chat， 多 人 在 线 交 谈 系 统 ) 接收 Travis CI 的 执行 结果 。 漏 掉 结 果 有 百 害 
而 无 一 利 ， 所 以 设置 时 一 定 要 选择 自己 经 常 关注 的 地 方 。 具 体 设置 方法 
请 参考 官方 文档 "。 




















e 将 Travis CI 的 结果 添加 至 README.md 


各 位 在 查看 GitHub 端 仓库 的 README.md 文件 时 ， 不 知 有 没有 见 
到 过 像 图 8.5 P “build passing” 那 种 绿色 或 红色 的 图 片 。 这 就 是 刚才 
Travis CI 的 执行 结果 。 


图 8.5 Travis CI 的 状态 图 

















README.md 


Boxen 


Em 














绿色 的 图 片 表 示 仓 库 内 代码 顺利 通过 了 测试 ， 相 反 红 色 的 图 片 表示 
仓库 没有 通过 测试 ,证明 仓库 很 可 能 存在 某 种 问题 。 将 执行 结果 显示 在 
README.md 中 ， 既 可 以 显示 仓库 的 健全 性 ， 又 可 以 防止 自己 遗漏 
Travis CI 的 结果 ， 一 举 两 得 。 

如 果 采 用 了 Markdown 语法 ， 只 需 按 下 面 格式 进行 描述 。 


[! [Build Status] (https://secure.travis-ci.org/ PEIGES .png 
)] (http://travis-ci.org/ 用 户 名 /仓库 名 ) 













































































(D http://about.travis-ci.org/docs/user/build-configuration/ 
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8.3 Coveralls 


e 概要 





N 


Coveralls” 是 由 Lemur Heavy Industries? 运营 的 代码 覆盖 率 检测 服 


务 。 借 助 Travis CI 或 Jenkins 等 持续 集成 服务 器 
的 测试 覆盖 率 ( 图 8.6 )。 


8.6 “代码 覆盖 率 的 报告 


COVERALLS 


hirocaster , lokka 
© GTHUB REPO © CI PROJECT 


EE BRANCH: (DETACHED FROM 1EC1973) ~ 


5 


BRANCH 


(detached from FETCH. HEAD) 


(detached from FETCH. HEAD) 


(detached from FETCH. HEAD) 


Z (detached from FETCH_HEAD) 


(detached from FETCH. HEAD) 


(detached from FETCH. HEAD) 


(detached trom FETCH. HEAD) 


(detached from FETCH. HEAD) 


(detached from FETCH. HEAD) 


(detached from FETCH. HEAD) 





e 
3 





， 向 用 户 报告 自动 测试 





ZE REPOS x UPDATES — O PRIVATE REPOS @DOCS — e BLOG — i, HIROCASTER — SIGN OUT 


COMMIT 


Merge 1ec197323 into 002a0af56 


Merge 166197323 into 002a0af56 


Merge 1e197323 into 002a0af56 


Merge 1ec197323 into 002a0af56 


Merge 16197323 into 002202156 


Merge 16197323 into 002a0af56 


Merge 16197323 Into 002a0af56 


Merge 1ec197323 into 002a0af56 


Merge 1ec197323 into 002a0af56 


Merge 166197323 into 002a0af56 


COMMITIER TYPE — TIME 

Quosse push  10Aug2013 
reo push 23 deys ago 
Qo push — 10Aug2013 
10 Aug 2013 
10 Aug 2013 
10 Aug 2013 
10 Aig zo1s 
10 Aug 2013 


10 Aug 2013 





10 Aug 2013 


+- PREVIOUS 1 2 3 









0, MEDAL OF HONOR 
81% 
one does simply deploy into 

VIA 

tavs 

tavs 

tavs 

tavs 

tavs 

tavs 

vavs 

tavs 

travs 

ovis 
NET 一 








该 服务 支持 Ruby/Rails、 


Python, PHP、JavaScript/Node.js、C/C++、 


Java, Scala 等 语言 。 详 细 内 容 请 查看 官方 网 站 的 相关 文档 ”。 
除 简略 报告 外 ， 用 户 还 可 以 查看 代码 每 部 分 执行 





息 (图 8.7)。 





(D https://coveralls.io/ 


@ http:/lemurheavy.com/ 


®© https://coveralls.io/docs 
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8.3 Coveralls 


图 8.7 ”详细 报告 





€ PREVIOUS VERSION (JOB #21.1) Next Version (Job #23.1) » 


module Markup 1 
class << self 1x 
attr_accessor :engine_lis 1 





def use engine 
Gengine list.each do |engine| 
return engine[2].call(text) if engine[0] == name 237, 
end 
text 43% 





end 
end 





Coveralls 可 以 为 每 一 个 Pull Request 生成 一 份 报告 ， 我 们 建议 各 位 
使 用 这 项 服务 ， 以 时 常 提 醒 自己 注意 覆盖 率 问 题 。 另 外 ， 由 于 用 户 可 以 
通过 详细 报告 了 解 哪 些 代码 没有 被 测试 ， 所 以 还 有 助 用 户 改 进 自动 测试 
的 内 容 ， 提 高 测试 效率 。 

这 项 服务 对 开源 开发 是 免费 的 ， 私 有 仓库 则 需要 支付 一 定 费用 。 具 
体 金额 请 查看 官方 网 站 ”。 









































D) 
















































































下 面 我 们 来 举例 讲解 Coveralls 的 安装 方法 。 
@ 安装 





Coveralls 的 安装 非常 简单 ， 但 使 用 时 有 前 提 条 件 。 


o 源 代码 保存 在 GitHub 上 
e 已 经 集成 了 Travis CI 或 Jenkins 等 服务 





只 要 满足 以 上 条 件 ， 就 可 以 立即 使 用 Coveralls。 本 章 中 我 们 讲解 如 


何 与 Travis CI 或 Jenkins 进行 集成 。 
这 次 我 们 借用 Ruby 开发 的 CMS 一 一 lokka” 来 进行 安装 。 


























访问 Coveralls 的 首页 并 点 击 FREE SIGN UP， 可 以 经 由 GitHub 注 
册 账 户 。 








(D https://coveralls.io/pricing 
@ https://github.com/lokka/lokka 
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@…… 添加 对 象 仓库 

账户 注册 成 功 后 再 到 Coveralls 的 首页 点 击 ADD REPO， 这 里 可 以 
添加 需要 生成 覆盖 率 报告 的 仓库 。 

页 面 中 会 列表 显示 我 们 在 GitHub 端的 仓库 ( 图 8.8 )， 添 加 时 只 需 
要 将 仓库 名 右边 的 开关 设置 为 ON。 
8.8 CEIR 

















COVERALLS 


ADD REPO 


FEE AGILE-SAMURAIJA / SUPPORT 





WEE] AGIESAMURALJA / DOJO-GATHERING © vew on omus You may need to ra-syne. 


O JOR AGLESMIURIIIA / TRAINING © view ON emus 
We omussoor/ nzzevzz © view ON mius. ee bulo ey 
supports public GitHub 
~ JO cmuesoor/ onere © view on omus S bibunt 
We HROCASTER/.GIT_TEMPLATE © view ON emus EL 
We HROCASTER / HATENA-TEXTBOOK © view ON GHHUB 
O WEE HRocASTER /neuo.won © vir ON GIHUR. 
7 FEES mocas /euocanvas © view ON GIHUB 
WEE! HROCASTER / HELLOOBJECT-C © view ON GMUB 
We mous /neuornaws © view ON mus. 
O DO moasre / HEuJQUERYMORILE © vir ON omus 
We mocas /imacevieweR © view ON GIHUB 
O POF HROCASTR / MARSEDITPLUGIN © view ON mus. 
- FEE! HROCASTER /PHPMATSURI-TDD © view ON GHUB 














iE REPOS — X UPDATES © PRIVATEREPOS © DOCS WEBLOG $. HIROCASTER © SIGN OUT 


SUBSCRIPTIONS. 


Just added a new repo to. 
GitHub? 


i SYNC GITHUB REPOS. 











返回 Coveralls 首页 ， 我 们 能 看 到 刚才 设置 为 ON 的 仓库 已 经 成 为 报 
告 对 象 。 点 击 链接 会 进入 图 8.9 所 示 的 页 面 ， 这 个 页 面 为 我 们 讲解 了 如 
何 编写 Coveralls 的 配置 文件 以 及 需要 安装 哪些 插件 。 





























— 编写 配置 文件 
Coveralls 的 配置 文件 是 .coveralls.yml。 我 们 将 这 个 文件 放 到 仓库 路 














径 下 。 文 件 内 容 妇 


Service name: travis-ci 




















I 下 所 示 。 





如 果 各 位 使 用 其 他 的 持续 集成 服务 器 ( Jenkins 等 )， 最 好 按照 自己 
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的 需要 将 service name 改 成 简单 易 懂 的 名 称 。 另 外 ， 这 种 情况 下 repo | 
token 需要 描述 成 repo_token:xxxxxyyyyyzzzz 的 形式 。repo_token 可 以 在 
图 8.9 所 示 的 页 面 中 找到 。 








图 8.9 Coveralls 的 配置 解说 页 面 


COVERALLS iE REPOS — X UPDATES © PRIVATE REPOS © DOCS WEBLOG — d, HIROCASTER © SIGN OUT 


hirocaster , lokka 
EE BRANCH: ~ ECTS © GIHUB REPO © CI PROJECT ET 


SET UP COVERALLS 


Here's some quick setup instructions for Ruby and Travis CI: 


First, if you are using Travis CI , make sure its buiding correctly. If you're using Travis Pro, add the following line to a .coveralls.yml fle in 
your repository's root: 


service name: travis-pro 


Or it you intend to submit coverage data via a private CI or command line, add the following line to your | .coveralls.yml |: 


repo token: Qc0g2mvHwjEgLQY3j H3dZghlxüpqnEUZn 


We are going to be adding 
«strong»Note: Do not make your repo token public.«/strong» oM d 


Sponsorstip logo placement on 
Coveralls, the placeholders above 
Give you an idea of how it wil lookon 
Add our gem to your Gemfile: od adiis 


For more information about 


gen 'coveralls', require: false 





In your | spec. relper.rb or test helper.rb or what have you: Tr Would be interested in being 
notifed when sel-serve sponsorships 
launch, give us your email address 


ici you: 


require 'coveralls* 
Coveralls.wear! 





# Your code here. 











@…… 添加 gem 

















如 果 使 用 Ruby 或 Rails， 还 需要 添加 gem。 使 用 其 他 语言 的 读者 请 
查看 官方 网 站 的 相应 文档 。 
我 们 在 Gemfile 中 添加 下 面 一 行文 字 。 


gem 'coveralls', require: false 























另外 ， 还 要 在 ./spec/spec_helperrb 或 ./test/test_helper.rb 等 各 位 正在 
俩 用 的 测试 工具 的 helper 文件 中 添加 下 面 这 段 代 码 。 


require 'coveralls' 











o 

















Coveralls.wear! 




















使 用 Rails 的 读者 请 替换 成 下 面 这 段 代 码 进行 设置 。 
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require 'coveralls' 


Coveralls.wear!('rails') 


执行 bundle install 命 令 后 ,记得 要 将 所 有 修改 过 的 文件 提交 一 遍 。 





完成 上 述 设 置 后 进行 push 操作 ，Coveralls 就 会 在 Travis CI 自动 测 
试 后 生成 报告 。Coveralls 报告 的 URL 为 https://coveralls.io/r/ 
用 户 名 /仓库 名 。 

与 Travis CI 一 样 Coveralls 也 提供 了 让 README.md 显示 相关 信息 
的 标记 。 在 报告 下 部 README BADGE 栏 内 的 图 片 下方 可 以 找到 Get badge 
URLs， 点 击 之 后 便 可 获得 URL (图 8.10 )。 将 URL 添加 至 README.md 
文件 后 ， 我 们 就 可 以 在 GitHub 上 看 到 与 README BADGE 栏 中 同样 的 
图 片 了 。 


8.10 Coveralls 的 标记 





























TECHNICAL DETAILS 
README BADGE PRIVATE 
faise 
Get badge URLs 
ADDED TRAVIS REPO 
about an hour ago 509717 
onus 











8.4 Gemnasium 


Gemnasium 服务 可 以 查询 GitHub 仓库 中 软件 正在 使 用 的 RubyGems 
或 npm ( Node Package Manager， 包 管理 器 )， 让 开发 者 了 解 自 己 是 否 正 
在 使 用 最 新 版 本 进行 开发 ”。 

















(D https://gemnasium.com/ 
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最 近 的 软件 都 会 用 到 多 个 库 。 因 此 ， 当 库 的 版 本 升级 时 ， 如 果 不 及 
时 应 对 ， 就 会 影响 到 软件 的 使 用 。 
比如 ， 帮 助 用 户 轻 松 使 用 GitHub API 的 RubyGems 中 有 octokit” 这 
样 一 个 库 ， 而 我 们 正在 开发 的 软件 正好 用 到 了 这 个 库 。 现 在 由 于 GitHub 
对 API 做 了 修改 ，octokit 只 好 升级 版 本 以 做 应 对 。 这 时 RubyGems.org 
上 一 定 会 发 布 新 版 本 的 octokit。 如 果 我 们 使 用 了 Gemnasium ， 就 会 第 一 
时 间接 到 通知 。 
另外 ， 在 Gemnasium 的 网 站 上 会 列 出 我 们 正在 使 用 的 RubyGems 及 
其 与 最 新 版 本 的 差距 。 版 本 方面 的 问题 可 以 在 这 里 一 目 了 然 (图 8.11 )。 



















































































图 8.11 “正在 使 用 的 RubyGems 以 及 相应 最 新 版 的 列表 
e © Gemnasium 


DASHBOARD > HIROCASTER > LOKKA 


© UPGRADE YOUR ACCOUNT 


A lokka zm 


CMS for Cloud. 


i= DEPENDENCIES A ALERTS D FILES % COMMENTS £ SETTINGS 


Runtime (17) Development (35) 






































Nam: Locked Requirement Lati st Chang, 
A bluefeath. 0 0.41 e9 
图 bundle 135 B 
be B 
国 dm-migrati 120 B 
A dm-pager 11.0 110 e 
A dm-tags 120 B 
im-validati 12. 
 dm-validati o B 
obi o B 


























Public 仓库 可 以 免费 使 用 Gemnasium, Private 仓库 则 需要 支付 一 定 
费用 。 如 果 各 位 有 公开 的 仓库 ， 推 荐 试 一 试 这 项 服务 。 








8.5 Code Climate 


Code Climate 是 一 款 代码 分 析 报告 服务 ”, 目 前 只 支持 Ruby。 这 项 服 





(D http:/rubygems.org/gems/octokit 
Q) https://codeclimate.com/ 
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务 可 以 分 析 GitHub 仓库 中 的 软件 ， 查 出 软件 中 质量 有 问题 的 代码 ， 同 
时 给 软件 品质 评级 。 这 是 一 项 收费 服务 ， 但 是 有 14 天 的 免费 试用 期 。 

Code Climate 可 以 在 我 们 的 日 常 开发 中 分 析 代 码 ， 对 容易 出 现 BUG 
的 复杂 部 分 发 出 警告 。 如 果 不 进行 重 构 ， 与 分 析 结 果 相 伴 的 评级 就 会 越 
来 越 低 (图 8.12 )。 这 样 一 来 可 以 督促 我 们 在 日 常 编写 高 品质 代码 ， 在 
评级 下 降 时 及 时 进行 重 构 ， 让 软件 时 常 保持 在 一 个 高 品质 状态 。 


8.12 ”解析 结果 评级 


Classes by Rating 
































Hotspots 


Q Quality::Worker::Jobs::CompareSnapshots 


Q Quality::Worker::Jobs::ScanVulnerabilities 





Q Quality::Worker::Jobs::FinalizeSnapshot 








Code Climate n] LAAS JH P9 KAREPE EX RHET HIAR, THE 
用 户 时 常 进行 重 构 。 强 烈 推 荐 日 常 使 用 Ruby 开发 的 读者 尝试 这 项 服务 。 








8.6 Jenkins 


e 概要 

Jenkins 是 代表 性 的 持续 集成 服务 占 ， 下 面 我 们 来 讲解 如 何 让 
Jenkins 与 GitHub 集成 。 

在 这 里 ， 我 们 将 把 GitHub 端 仓 库 发 来 的 Pull Request 设置 为 触发 
器 ， 让 系统 自动 进行 测试 ， 并 将 测试 结果 发 送 至 GitHub。 通 过 这 种 方法 
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可 以 检验 收 到 的 Pull Request 会 不 会 破坏 软件 原 有 功能 。 另 外 ， 如 果 
Pull Request 会 给 革 些 功能 带 来 BUG 而 无 法 通过 测试 ， 那 么 这 个 Pull 
Request 将 会 像 图 8.13 中 那样 显示 在 GitHub 上 ， 防 止 管理 员 误 合并 。 








8.13 Pull Request 未 通过 测试 时 显示 的 内 容 
Add fail spec #1 ca EI 


| P1 Open | hirocaster wants to merge 2 commits into master from pri 





M Conversation 1 © Commits 2 国 Files Changed 3 4 uuum 
E hirocaster opened this pull request 10 months ago f Labels 
None yet 
No description provided. 
Milestone. 
No milestone 


lj] hirocaster added some commits 10 months ago 





IE] ^dd fail spec 
IB rix rake x ft 


Assignee 





No one assigned 


Add more commits by pushing to the prl branch on github-book/ghprb. 
Notifications 


X Failed 一 Merged build finished. - Details «4x Unsubscribe 


Merge with caution! mm 
a Merge pull request 
You can also merge branches on the command line. AAA 1 participant 


通过 测试 的 Pull Request 将 会 像 图 8.14 中 那样 以 绿色 显示 。 它 表示 
该 Pull Request 至 少 成 功 运行 了 所 有 测试 代码 。 














图 8.14 Pull Request 通过 测试 时 显示 的 内 容 
Fix spec #2 zar EJ 


EE hirocaster wants to merge 3 commits into master from pr2 





MI Conversation 1 © Commits 3 [£] Files Changed 3 4 uuum 
E hirocaster opened this pull request 10 months ago f Labels 
None yet 
No description provided. 
Milestone 
[j  hirocaster added some commits 10 months ago No milestone 

IE] Add fail spec 
Assignee 

IB Fix rake 

: No one assigned 
M Fix spec 





Notifications 
Add more commits by pushing to the pr2 branch on github-book/ghprb. 
4 Unsubscribe 


v All is well Merged build finished. - Details 
1 participant 


WO 
You can also merge branches on the command line. i Merge pull request g 


测试 成 功 的 结果 一 目 了 然 ， 让 开发 者 能够 放心 进行 合并 。 另 外 ， 即 
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使 没 能 通过 测试 ，Jenkins 也 会 持续 对 该 Pull Request 进行 测试 ， 让 开发 
者 轻松 找 出 发 生 问题 的 时 间 点 。 





r yt 
e xx 


Jenkins 的 官方 网 站 ” EAT f Linux 等 多 种 OS 下 的 安装 包 。 各 位 
可 以 从 官方 网 站 的 右 侧 选择 合适 的 安装 包 进行 下 载 。 

下 载 完 成 后 要 使 用 当前 OS 的 标准 安装 方法 进行 安装 。Jenkins 在 众 
多 环境 中 都 有 运行 实例 ， 各 位 大 可 选择 自己 熟悉 的 环境 。 当 然 ， 需 要 进 
行 持续 目标 软件 最 好 在 当前 环境 中 可 以 运行 。 
通过 i kjam, Jenkins 会 随 OS 一 起 启动 ， 其 他 设置 也 会 
Te 只 要 安装 正常 ，Jenkins 将 会 默认 使 用 8080 端口 。 各 位 可 以 
打开 浏览 需 访 问 “ Pos //jenkins 所 在 服务 器 的 IP 地址 :8080/”， 会 看 到 如 
图 8.15 的 页 面 










































































o 





图 8.15 Jenkins 的 初始 界面 
: Jenkins 





Jenkins 公证 自动 唱 新 
Sye Sämi 
& 及 欢迎 使 用 Jenkins! 

Em aape 

pp | 开始 创建 一 个 新 任务 


A Credentials 


构建 队列 = 
队列 中 没有 构建 任务 


构建 执行 状态 - 


1 空闲 











至 于 端口 号 等 JVM 的 设置 ， 不 同 的 安装 包 之 间 有 所 不 同 。 使 用 deb 
格式 的 Debian GNU/Linux 或 Ubuntu 等 Linux 在 /etc/default/jenkins 中 进 
行 设置 ， 而 使 用 rpm 格式 的 Red Hat Linux 或 CentOS 则 在 /etc/sysconfig/ 
jenkins 中 进行 设置 。 详 细 位 置 请 参照 官方 网 站 的 Wiki 页 。 

















D http://jenkins-ci.org/ 
@ https://wikijenkins-ci.org/display/JENKINS/Native+Packages 
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e 创建 bot 账户 


我 们 要 在 GitHub 上 新 建 一 个 账户 ， 让 Jenkins 通过 这 个 账户 从 仓库 
获取 源 代码 以 及 向 GitHub 发 送 测试 结果 。 今 后 我 们 将 这 个 账户 称 为 bot 
账户 。 

然后 要 创建 bot 账户 专用 的 公开 密 钥 和 私有 密 钥 。 通 过 安装 包 安 装 
Jenkins 时 ，OS 中 会 创建 一 个 jenkins 用 户 ， 使 用 这 个 用 户 来 创建 密 钥 可 
以 自动 分 配 私 有 密 钥 ， 省 去 后 续 的 麻烦 。 要 注意 的 是 ， 这 个 密 钥 的 密码 
短语 (Passphrase ) 一 定 要 留 空 。 由 于 Jenkins 要 通过 这 个 密 钥 访问 
GitHub 的 仓库 ， 如 果 设 置 了 密码 短语 ， 再 想 让 测试 全 自动 进行 可 就 要 费 
一 番 功 夫 了 。 

接 下 来 将 新 创建 的 无 密码 短语 的 公开 密 钥 添加 到 bot 账户 中 。 

账户 的 创建 及 设置 请 参考 第 3 章 。 
















































































@ bot 账户 的 权限 设置 


我 们 需要 给 bot 账户 设置 GitHub 端 持续 集成 对 象 所 在 仓库 的 访问 
权限 。 

公开 仓库 虽然 可 以 读 取 ， 但 要 将 结果 添加 至 GitHub 就 必须 拥有 写 
入 权限 。 另 外 ， 如 果 对 象 是 非 公开 仓库 ， 没 有 读 取 和 写 和 人 权限 的 话 bot 
是 无 法 访问 仓库 数据 的 。 


o- 对 象 为 个 人 账户 时 


如 果 GitHub 端的 仓库 归属 于 个 人 账户 ,需要 从 GitHub 的 仓库 页 面 进 
A Settings 页 面 ， 将 bot 账户 添加 到 Collaborators 中 。 添 加 在 这 里 的 账户 
能 够 获得 这 个 仓库 的 写 入 ( push 等 ) 和 读 取 (clone, pull 等 ) 的 权限 。 





























@…… 对 象 为 Organization 账户 时 











如 果 仓 库 归属 于 Organization 账户 ， 则 需要 在 GitHub 页 面 左 上 角 的 
切换 账户 处 选择 Organization 账户 。 进 入 Organization 账户 页 面 选择 
Teams 标签 页 ， 打 开 团 队 一 览 (图 8.16 )， 然 后 选择 New Team, Zi bot 
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账户 创建 一 个 新 的 团队 。 
8.16 ”团队 一 览 











github-book & Members 3 f Teams 4 
1 Find a team My teams New team 
owners developer Join 
1 member - 6 repositories 2 members - 1 repository 
Sr 











接 下 来 输入 团队 相关 的 设置 (图 8.17)。 在 Team Name 处 输入 团队 
名 。 这 里 我 们 将 团队 名 定 为 bot "What permission level should this team 
have?” 处 可 以 选择 这 个 团队 拥有 的 权限 。 这 里 要 选择 Write Accesso Ex 
后 点 击 Create team 即 可 创建 团队 。 








8.17 ”创建 团队 与 权限 设置 





github-book & Members 3 fj Teams 2 





Create new team 


Team name (only letters, numbers and dashes are allowed) 
bot + 


Mention this team in conversations as @github-book/bot. 


What permission level should this team have? 
O Read Access 
This team will be able to view and clone its repositories. 


(9 Write Access 
This team will be able to read its repositories, as well as push to them. 


O Admin Access 


This team will be able to push/pull to its repositories, as well as add other 
collaborators to them. 


=S 











在 接 下 来 的 页 面 中 要 设置 bot 团队 的 成 员 与 仓库 ( 图 8.18 )。 团 队 所 
属 成 员 的 账户 在 页 面 左 侧 添 加 。 这 里 我 们 的 bot 账户 名 为 hirocaster-bot。 
页 面 右 侧 可 以 添加 与 该 团队 关联 的 仓库 。 我 们 要 进行 持续 集成 的 对 象 在 
github-book/ghprb 中 ， 于 是 我 们 将 它 添加 进去 。 



































图 灵 社 区 会 员 lxghost2 专 享 尊重 版 权 











8.6 Jenkins 167 
图 8.18 团队 成 员 与 仓库 的 设置 
github-book & Members 4 fj Teams s 
bot Jon $3 
Jenkins bots — Edit 
\ Filter by usemame 9* Add member 1 Filter repositories E* Add repository 
bd hirocaster-bot peer github-book / ghprb Remove 








团队 名 下 方 显示 的 团队 说 明 可 以 通过 点 击 Edit 来 修改 。 在 这 里 填写 
简单 的 团队 说 明 可 以 在 团队 增多 后 方便 整理 ， 所 以 建议 大 家 多 花 点 时 间 
写 上 概要 。 

全 部 输入 完成 后 点 击 右上 角 的 Teams， 查 看 已 创建 的 团队 。 

















e— 检查 设置 


至 此 ， 我 们 完成 了 bot 账户 对 持续 集成 对 象 仓库 的 权限 设置 。 现 在 
退出 GitHub 重新 登入 bot 账户 ， 确 认 是 否 能 看 到 该 仓库 。 

今后 如 果 增 加 了 新 的 持续 集成 对 象 仓库 ， 只 需 给 本 次 创建 的 团队 添 
加 仓库 ， 就 可 以 让 bot 账户 获得 访问 仓库 的 权利 。 











@ 给 Jenkins 设置 SSH 密 负 
由 于 Jenkins 要 使 用 bot 账户 的 私有 密 钥 访问 仓库 ， 所 以 必须 设置 一 
个 私有 密 钥 。 




















@…… 初次 使 用 Jenkins 时 





通过 安装 包 安 装 Jenkins 后 ，OS 中 会 自动 生成 一 个 jenkins 用 户 。 
如 果 在 这 个 jenkins 用 户 下 生成 新 的 密 铀 ， 那 么 私有 密 钥 就 已 经 自动 配 
置 完毕 ， 不 需要 多 做 更 改 。 

如 果 新 密 钥 不 是 在 jenkins 用 户 下 生成 ， 则 需要 在 jenkins 用 户 的 个 
人 文件 夹 起 始 目录 下 创建 .ssh HR, 在 .ssh 目录 下 配置 私有 密 铀 (id_ 
rsa )。 比 如 在 Ubuntu 等 Linux 的 派生 操作 系统 下 ， 私 有 密 钥 的 路 径 就 是 
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/Var/lib/jenkins/.ssh/id_rsa。 配 置 私 有 密 钥 之 后 ，jenkins 用 户 就 可 以 自动 


使 用 这 个 私有 密 钥 通过 SSH 进行 访问 。 然 后 只 要 将 Jenkins 的 job 设置 
成 通过 SSH 访问 GitHub 仓库 ，Jenkins 就 可 以 访问 仓库 了 。 























已 经 在 使 用 Jenkins 时 

















如 果 已 经 使 用 Jenkins 为 其 他 项 目 进行 持续 集成 并 且 占用 了 id_rsa 
文件 ， 就 需要 花 一 些 功夫 了 。 我 们 要 在 ~/.ssh/config 中 写 和 人 SSH 客户 端 
的 相关 设置 ， 为 SSH 访问 特定 主机 时 ， 设 置 要 访问 的 实际 主机 名 以 及 对 
应 的 私有 密 钥 。 

在 jenkins 用 户 的 ~/.ssh/config 中 添加 下 面 的 代码 。 


Host ghprb.github-book 
Hostname github.com 
IdentityFile -/.ssh/bot id rsa QEA PESE] 
StrictHostKeyChecking no 























Host * 
IdentityFile -/.ssh/id rsa Qeagchd ch PN dut s oz 








在 ~/.ssh/bot id rsa 中 配置 我 们 新 创建 的 私有 和 密 钥 。 由 于 是 私有 密 
钥 ， 我 们 将 权限 设置 为 400。 
通常 情况 下 我 们 是 通过 git@github.com:github-book/ 
ghrpb .git 访 问 GitHub 仓库 的 。 但 是 经 过 本 次 设置 后 ， 在 通过 
Jenkins 访问 仓库 时 ， 请 将 上 面 主机 名 的 部 分 替换 为 本 次 设置 的 HOST 
名 ， 比 如 gitegithub .com:github-book/ghrpb .9git 就 需要 修改 
成 gite@eghprb .github-book:github-book/ghrpb .git。 

设置 完成 后 ，Jenkins 在 通过 SSH 访问 不 同 主机 时 就 可 以 使 用 不 同 
的 私有 密 钥 了 。 

现在 我 们 的 jenkins 用 户 已 经 可 以 使 用 bot 账户 的 私有 密 钥 访 问 
GitHub 仓库 了 。 我 们 不 妨 先 在 jenkins 用 户 下 尝试 clone 等 操作 ， 确 认 能 
否 正常 执行 ， 以 便 在 后 面 job 设置 出 问题 时 能 快速 找到 原因 。 
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e GitHub pull request builder plugin 的 安装 








使 用 Jenkins 对 Pull Request 进行 自动 测试 时 ， 需 要 用 到 GitHub pull 
request builder plugin” 插 件 ”。 这 个 插件 可 以 在 Jenkins 内 部 构建 出 Pull 
Request 合并 之 后 的 状态 并 执行 自动 测试 。 由 于 其 结果 会 自动 发 送 到 
GitHub ， 所 以 能 够 让 我 们 避免 “Pull Request 合并 后 出 现 了 某 些 问题 导致 测 
试 未 通过 ”的 情况 。 如 此 一 来 ，Pull Request 的 合并 就 变 得 更 加 安全 了 。 
现在 我 们 将 这 个 插件 安装 到 Jenkins Eo 
访问 Jenkins 的 主 界面 ， 依 次 选择 “系统 管理 ”一 “管理 插件 ”， 然 
选择 “可 选 插件 ”标签 页 。 e a p GitHub pull request builder 
plugin， 色 选 安装 复 选 框 ， 点 击 直接 安装 ( 图 8.19 )。 随 后 相应 插件 就 会 
安装 到 系统 中 ( 图 8.20 )。 
接 下 来 我 们 继续 进行 Jenkins 的 设置 。 首 先 打 开 “ 系 统管 理 ” 一 “ 系 
统 设置 ”页 面 。 














































































































图 8.19 ”选择 GitHub pull request builder plugin 


LEM [. ——JL 
Jenkins 插件 管理 

会 返回 xii: [X GitHub 

其 系统 管理 


É Update Center 


can put this URL into other sites (such. 1-7 
id 


blie 和 s plugin in does not have any user visible 





ns with Github projects 


, Selenium Builder Ph 


mak EE 2322s MIN 














(D https;//wiki.jenkins-ci.org/display/JENKINS/GitHub--pull-request-builder-plugin 
D 本 书 使 用 的 是 L9 版 本 。 
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8.20 “相关 插件 已 安装 完毕 





@ Jenkins 
Jenkins Update center 企 许 自动 剧 新 
EIE 
会 zm 安装 /更 新 插件 中 
系统 管理 
» 准备 
管理 插件 * Checking internet connectivity 
* Checking jenkins-ci.org connectivity 
* Success 
Locale Plugin Q x 
Git Client Plugin Qo 完成 
Git Plugin o 完成 
GitHub API Plugin Q sz 
GitHub Plugin Q xz 


GitHub pull request builder plugin Qo 完成 


panin 
(返回 首页 使 用 已 经 安装 好 的 插件 ) 
gp 口 安装 完成 后 重启 Jenkins( 空 闲 时 ) 








出 大助 我 们 本 地 化 当前 页 生成 页 面 : 2015-5-11 23:43:41 RESTAPI Jenkins ver. 1.590 





@ Git plugin 的 设置 


点 击 “ 配 置 ” 下 拉 菜 单 中 的 Git plugin， 移 动 至 Git plugin MH (图 
8.21 )。 





8.21 Git plugin 











Jenkins 配置 
Git plugin 
lobal Confi 
Global Config user.name Value PR e 
Global Config user.email Value 
ee hohtsuka@gmail. com © 
Create new accounts base on author/committers email Eg e 





现在 我 们 来 设置 Jenkins 内 部 使 用 的 Git, TE Global Config uesr.name 
Value 中 输入 姓名 ， 在 Global Config user.email Value 中 输入 邮箱 地 址 。 
要 注意 ， 这 两 项 都 是 必 填 项 。 











e Github Pull Requests Builder 的 设置 


接 下 来 我 们 移动 至 Github Pull Requests Builder 项 目 ， 然 后 点 开 项 目 
下 部 的 “高 级 ”。 
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e Github server api URL 














如 果 各 位 使 用 的 是 普通 的 GitHub ， 那 么 这 项 不 需要 更 改 ， 如 果 使 用 
的 是 GitHub Enterprise， 则 需要 配合 环境 进行 设置 。 











e Access Token 


Jenkins 5j GitHub 之 间 的 互动 其 实 就 是 通过 bot 账户 的 Access Token 
与 GitHub 的 API 进行 信息 交互 ， 因 此 需要 获取 bot 账户 的 Access Token。 

填写 下 方 的 Username 与 Password 后 点 击 Create access token, Jenkins 
就 会 自动 通过 bot 账户 的 Username 和 Password 获取 Access Token。 

成 功 获取 后 ， 该 部 分 附近 会 显示 一 长 串 随机 文字 列 。 只 要 将 这 个 文 
字 列 复制 到 上 数 第 二 项 Access Token 栏 中 即 可 。 











图 8.22 Access Token 的 设置 























Jens 5 ER 
GitHub Web Hook 
Let Jenkins auto-manage hock URLs e 
® Manually manago hock URLs e 
Re-regster nooks tor aliobs 
mips:iapi gthub.cem 
e 
n updating commit status fails 加 e 
as: tiggered et 相 — m 
o e 
Admin list 
Mark Unstable build in github as Frm" e 
Published Jerkins URL e 
,0 
j e 
epito e 
st pas "testWsthisWepleasgi e 
Skip build phrase pre e 
á "stt e 
Dé succes inesse Test PASSed 
Dos failure message TELA 
Username 
Pasewerd 
E 
uicit EM AE: 2015-512212040 RESTAPI Jankinsver 1500 
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e Admin list 





GitHub pull request builder plugin 可 以 让 用 户 通 过 在 GitHub 的 Pull 
Request 中 添加 特定 评论 的 方式 ， 给 Jenkins 发 送 “ 执 行 任务 ”等 命令 。 
我 们 需要 在 这 里 添加 GitHub 的 用 户 名 ， 将 上 述 权限 赋予 该 用 户 。 新 寻 
任务 时 ， 相 关 权 限 将 会 以 这 里 的 设置 为 默认 值 。 当 然 ， 在 每 个 任务 中 也 
可 以 单独 进行 设置 。 

以 上 全 部 输入 完毕 后 点 击 保存 。 














Har 














e job 的 创建 与 设置 
Jenkins 的 任务 用 来 执行 自动 测试 ， 现 在 我 们 在 Jenkins 中 实际 创建 
个 。 点 击 “ 创 建 一 个 新 任务 ”， 给 任务 起 一 个 合适 的 名 称 ， 然 后 选择 
“构建 一 个 自由 风格 的 软件 项 目 ”。 
下 面 是 任务 的 设置 ， 我 们 只 讲解 必须 进行 的 设置 ， 其 他 设置 请 各 位 
根据 自己 的 需要 进行 判断 。 




















e GitHub project 


在 GitHub project 中 输入 GitHub 仓库 的 URL, 例如 https:// 
github.com/github-book/ghprb/ 等 。 





e- 源码 管理 


在 “源码 管理 ”中 选 W823 “源码 管理 系统 设置 





























择 Git (图 823), Repository [ssw 
URL 要 填 SSH 协 议 的 RN 
oci 
URL , ffi i 如 g i t @g d thub. Pipe Repository URL [ gitGghprb.github-book;github-book/ghprb.git e 
Q) Please enter Git repository. 
com: github-book/ Ordena [na $) [MRa 
; ES lame e 
ghprb .git。 如 果 在 前 : - 
iefspec +refs/pull/*;refs/remotes/origin/pr/* 

EA 的 ~/.ssh/config 中 re E 

进行 Ti 设 "a ny 注意 意 替 换 Branches to build Branch Specifier (blank for any) [Sha e 
3 机 名 o Add Branch Delete Branch 
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接 下 来 选择 Repositories 的 “高 级 ”。 在 Refspec 中 输入 以 下 内 容 。 
*refs/pull/*:refs/remotes/origin/pr/* 

在 Branches to build 的 Branch Specifier(blank for default) 中 输入 以 下 
内 容 。 


$(sha1) 


@…… 构建 触发 器 


在 “构建 触发 器 ”中 我 们 需要 设置 让 任务 开始 执行 的 触发 器 (图 
8.24 )。 先 匀 选 Github Pull Requests Builder， 然 后 点 击 “ 高 级 ”。 

在 Admin list 中 输入 管理 者 的 用 户 名 。 

Crontab line 需要 按照 Cron 的 格式 进行 描述 。Jenkins 会 按照 这 里 设 
置 的 时 间 检 查 Pull Request。 默 认 设 置 为 每 5 分 钟 检查 一 次 。 


























图 8.24 job 中 Github Pull Requests Builder 的 设置 


Jenkins github-book-ghprb > ERE 





Æ GitHub Pull Request Builder 
Admin list 


Use github hooks fcr build triggering a © 


Success message 


Failure message 





d 
e 
e 
AIskipWsci 
e 
4 
Crontab line "mm e 


Would last have run at 2015 年 5 月 12 日 星期 二 下 
午 10 时 01 分 07 秒 CST; would next run at 2015 年 5 
月 12 日 EI 下午 10 时 01 分 07 秒 CST. 


White list 


Comment file path e 


dithub-bcok 
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在 White list 中 填写 有 可 能 向 自己 发 送 Pull Request 的 GitHub 用 户 
名 。 当 接收 到 Pull Request 时 ， 如 果 发 送 方 的 用 户 名 在 White list 或 
Admin list 之 中 ，Jenkins 就 会 自动 执行 任务 。 

如 果 在 “List of organisations. Their members will be whitelisted” 中 
输入 Organization 账户 ， 那 么 隶属 该 账户 的 所 有 GitHub 用 户 都 会 获得 与 
White list 相同 的 权限 。 














“构建 ”用 来 设置 执行 自动 测试 等 作业 的 流程 。 这 里 请 各 位 根据 自 
己 正在 开发 的 软件 进行 设置 。 

以 上 我 们 完成 了 最 低 限 度 的 设置 。 现 在 只 要 接收 到 Pull Request, 4E 
务 就 会 自动 执行 。 但 是 Pull Request 的 发 送 者 必须 在 Admin list 或 White 
list 之 中 。 

其 他 开发 者 送 来 Pull Request 时 ， 需 要 由 Admin list 中 的 用 户 填写 评 
论 进行 控制 ， 比 如 将 该 开发 者 加 入 White list， 或 者 直接 允许 测试 执行 
等 。 关 于 这 方面 我 们 会 在 后 面 详细 讲解 。 





















































@ 通知 结果 
自动 测试 的 结果 会 由 GitHub pull request builder plugin 发 送 到 
GitHub。 这 时 要 用 到 的 API 名 为 Commit Status API”, 
接收 到 Pull Request 时 ， 持 续集 成 服务 器 会 进行 处 理 然 后 发 送信 息 ， 
随后 会 根据 最 新 提交 显示 如 图 8.25 的 状态 。 
8.25 ”显示 Pull Request 的 状态 


E w All is well 一 Merged build finished. - Details 


This pull request can be automatically merged. 


You can also merge branches on the command line. 






































这 一 状态 附带 名 为 Details 的 链接 ， 指 向 我 们 刚刚 设置 的 Jenkins。 








(D https;//github.com/blog/1227-commit-status-api 
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点 击 这 个 链接 可 以 查看 相关 的 详细 内 容 。 


e…… 测试 执行 中 的 状态 
接收 到 Pull Request 之 后 ， 如 果 自 动 测试 仍 在 执行 中 无 法 确定 状态 ， 
则 会 显示 为 图 8.26 的 样子 。 这 时 只 要 稍 等 一 会 ， 等 GitHub 接收 到 测试 
结果 ， 状 态 就 会 被 更 新 。 
8.26 “ 测试 执行 中 的 状态 


* Waiting to hear about Oedcdeb — Merged build started. - Details 


Merge with caution! 
Mei ull uest 
You can also merge branches on the command line. a aL ua 























如 果 有 某 项 测试 没有 通过 ， 则 会 显示 图 8.27 的 状态 。 
8.27 ”测试 未 通过 时 的 状态 


um X Failed — Merged build finished. - Details 


Merge with caution! 
Merge pull uest 
You can also merge branches on the command line. a DN Serbie, 














这 时 可 以 点 击 Details 链接 查看 详细 内 容 ， 找 出 没 过 测试 的 问题 
所 在 。 要 注意 ， 这 个 状态 下 千 万 不 能 合并 Pull Requests 





e All is well 


如 果 测 试 全 部 正常 通过 ， 会 如 图 8.25 中 那样 以 绿色 显示 。 之 后 只 要 
代码 审查 等 工作 没有 发 现 问题 ， 就 可 以 合并 了 。 




















e commit status 

GitHub pull request builder plugin 虽然 是 根据 最 新 的 提交 来 执行 任 
务 ， 但 是 也 会 记录 过 SUE 交 状 态 。 如 果 测 试 未 通过 ， 该 提交 会 像 图 
8.28 里 那样 被 标 上 “ 
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8.28 ”测试 未 通过 时 的 标记 


Add fail spec 
Fix rake x 


将 其 修正 再 push 后 ， 会 如 图 8.29 中 那样 标 上 绿色 对 勾 。 
8.29 ”测试 通过 时 的 标记 


Add fail spec 
B rix rake x 
Il rix spec 


根据 这 些 结果 记录 ， 可 以 直观 地 分 辨 出 哪些 提交 引起 了 测试 结果 的 
变化 ， 帮 助 开 发 者 迅速 地 辨 明 问 题 所 在 。 
































通过 评论 进行 控制 


在 GitHub 的 Pull Request 中 填写 特定 评论 可 以 控制 GitHub pull 


request builder plugin。 


e-— 执行 任务 


如 果 是 Admin list 和 White list 名 单 之 外 的 用 户 发 来 Pull Request， 
bot 账户 会 询问 “Can one of the admins verify this patch?”。 这 种 情况 下 任 
务 不 会 自动 执行 。 

Admin list 名 单 中 的 用 户 可 以 通过 发 送 “ok to test” 的 评论 让 任务 开 
始 执行 。 如 果 发 送 评 论 的 用 户 不 在 Admin list 当中 则 会 被 bot 账户 忽略 。 
如 果 发 送 Pull Request 的 用 户 在 White list 之 中 ， 则 任务 会 自动 开始 执行 。 


























@…… 添加 至 White list 


























如 果 想 将 发 送 Pull Request 的 用 户 添 加 至 White list， 就 用 Admin list 
名 单 中 的 用 户 发 送 “add to whitelist” 的 评论 。 今 后 这 个 用 户 发 来 Pull 
Request 的 话 ， 任 务 都 会 被 自动 执行 ( 图 8.30 )。 








。… 重新 执行 任务 
如 果 遇 到 某 些 情况 需要 重新 执行 任务 ， 只 要 Admin list 或 White list 
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名 单 中 的 用 户 发 送 “retest this please” 的 评论 即 可 。 
e 变更 指定 评论 


虽 定 评论 的 内 容 可 以 在 “系统 管理 ”一 “系统 设置 ”一 “Github 
Pull Requests Builder” 一 “高 级 ”中 进行 更 改 。 











图 8.30 ”发送 “add to whitelist” 评 论 的 示例 





V" Conversation. 4 CCommits 1 A Files Changed 司 
» yuria opened this pull request 10 months ago 5) 
No description provided. 
ib Add test 
bd hirocaster-bot commented 10 months ago f O 
Can one of the admins verify this patch? 


hirocaster commented 10 months ago 
4 


ok to test 


hirocaster commented 10 months ago 


add to whitelist 











8.7 小结 


通过 使 用 Jenkins fll GitHub pull request builder plugin， 我 们 可 以 更 

安全 地 合并 GitHub 的 Pull Request。 第 9 章 中 我 们 也 会 接触 到 自动 测试 
和 持续 集成 的 相关 内 容 。 在 现代 的 软件 开发 中 持续 集成 已 经 不 可 或 缺 ， 
甚至 逐渐 成 为 开发 中 的 常识 。 在 开源 世界 中 也 是 同样 。 
在 了 解 一 遍 过 程 之 后 ， 持 续集 成 的 安装 会 变 得 很 简单 。 但 是 在 认证 
和 权限 设置 方面 仍 存 在 很 多 难以 处 理 的 东西 ， 往 往 让 人 们 花费 大 量 时 
间 。 因 此 本 书 详细 讲解 了 如 何 让 其 与 GitHub 集成 。 各 位 不 妨 参考 本 书 
尝试 一 下 持续 集成 的 应 用 。 
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第 8 章 与 GitHub 相互 协作 的 工具 及 服务 





专栏 : 用 Coderwall 生成 GitHub 上 的 个 人 信息 




















Coderwall ^? 是 Hh} 


区 众 筹 





它 可 以 根据 GitHub 的 仓 











的 方式 








发 、 运 营 的 一 款 服 务 ， 




















库 信 息 等 为 

















业绩 与 成 就 给 








同时 根据 在 GitHub 上 的 





发 者 颁发 勋章 ( 图 











发 者 免费 生成 个 人 信息 ， 


a )。 

















这 是 一 张 可 以 证 明 








发 者 使 

















何 种 语言 参与 了 多 少 个 项 目 











的 

















证 书 。 根 据 其 





所 获得 的 勋章 就 可 以 判断 














av Nw 
感 兴 


的 人 ， 














不 妨 查看 一 下 他 1 











这 些 勋 章 可 
在 个 人 信息 栏 里 二 "。 





Coderwall 中 的 Teams ^* 是 


队 资 料 ， 





"w 








既 可 以 上 传 自己 的 团 

















以 嵌入 到 博客 等 


这 个 人 的 特点 。 各 
门 的 个 人 信息 。 





立 如 果 











网 站 ， 各 位 可 以 试 着 把 它 








展示 各 团 





队 的 地 方 ， 在 这 








eB 





n ATAN 


Ja 
E, T 




















展示 


自己 的 团队 成 绩 和 文化 




















道 合 的 同 





URS 
GitHub 上 


f£, 


志 同 











发 什么 代码 以 及 





也 可 


JEER 

















他 团队 


， 以 此 














那些 程序 员 ， 在 











也 们 的 











团队 文化 。 






































有 意 跳 槽 的 人 可 以 在 这 号 


























公司 还 没有 参与 
一 种 交流 的 平台 。 





注 a https://coderwall.com/ 


有 查看 是 否 有 心仪 的 
来 ， 也 不 妨 借 这 个 机 会 








团队 。 如 果 您 的 











展示 


注 b https://coderwall.com/api#blogbadge 
注 c https://coderwall.com/leaderboard 


图 a 


Coderwall 的 勋章 


下 ， 将 这 里 作为 








ruby 


Has open sourced 7 ruby projects 


php 


Has open sourced 5 php projects 


open source 


objective-c 


Has open sourced 3 objective-c projects 


四 四 
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在 开发 流程 中 使 用 GitHub， 可 以 将 开发 团队 的 能 力 发 挥 到 最 大 限 
度 。 下 面 我 们 就 为 各 位 介绍 这 类 开发 流程 。 
本 章 中 讲解 的 “开发 流程 ”， 是 指使 用 了 Git GitHub 的 团队 开发 
所 涉及 的 规则 及 步骤 。 接 下 来 的 部 分 我 们 将 会 讲解 2 种 开发 流程 ， 每 个 
流程 都 有 各 自 不 同 的 特征 。 在 实际 开发 中 究 竞 要 采用 哪 一 种 ， 需 要 根据 
现场 团队 的 情况 来 决定 。 

对 于 不 熟悉 Git 和 GitHub 的 团队 ， 推 荐 以 本 书 为 参考 来 制定 开发 规 
则 及 步 又 的 草案 。 

































































9.1 团队 使 用 GitHub 时 的 注意 事项 





在 详细 讲解 使 用 Git 与 GitHub 的 开发 流程 之 前 ， 我 们 先 来 看 一 看 由 
软件 开发 者 们 组 成 的 团队 要 想 最 大 限度 地 发 挥 出 他 们 的 能 力 需要 具备 哪 


些 前 提 条 件 。 








@ 一 切 从 简 

面向 企业 发 售 的 开发 者 工具 或 协作 工具 往往 拥有 十 分 丰富 的 功能 。 

某 些 企业 为 使 用 这 些 丰 富 功能 ， 会 专门 为 其 制定 软件 开发 规则 。 然 而 不 

妨 反思 一 下 ， 我 们 所 处 的 开发 现场 真 的 需要 这 么 多 功能 和 规则 吗 ? 
GitHub 的 各 项 功能 都 非常 简单 ， 就 是 因为 在 实际 的 软件 开发 中 ,， 往 

往 用 不 到 那些 复杂 度 极 高 的 功能 。 




























































































@…… 项目 管理 工具 与 GitHub 的 区 别 





比如 图 9.1 所 示 的 著名 开源 项 目 管理 工具 Redmine 的 新 建 问题 页 ， 
从 繁多 的 可 输入 项 目 中 我 们 就 可 以 看 出 其 功能 的 丰富 程度 。 而 且 
Redmine 还 有 众多 插件 ， 可 以 为 其 进一步 添加 功能 。 然 而 GitHub 的 
New Issue 页 却 如 图 9.2 所 示 ， 非 常 简单 。 
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图 9.1 Redmine 的 新 建 问题 页 











概述 ”活动 ”日报 “问题 iro E Ha am s xë Wikii 文件 RE 


新 建 问题 
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主题 * 
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AREE y 开始 日 期 20150519 E) 
EY y 计划 完成 日 其 B 
BUNA Mi 
PER 0% A 
文件 DERRE PARERI (RARS: 5 MB) 
REA ogussugnostsumes 
CEI G0 


Powered by Redmine © 2006-2014 Jean-Philippe Lang 





9.2 GitHub 的 New Issue 页 


Browse Issues Milestones LI 


E | [rite Add Labels 











I bug 
No one is assigned. d No milestone d 
duplicate 
Write Preview Comments are parsed with GitHub Flavored Markdown 1 enhancement 
invalid 
u 
Leave a comment ll question 
wontfix 


Attach images by dragging & dropping, selecting them, or pasting from the clipboard. 











为 什么 会 有 如 此 差距 呢 ? 
@…… 项 目 管理 工具 与 GitHub 相 异 的 原因 


Redmine 等 项 目 管理 工具 是 以 管理 项 目 为 目的 的 ， 势 必要 考虑 管理 
人 员 会 输入 哪些 信息 ， 以 及 需要 提醒 管理 人 员 输 入 哪些 信息 ， 所 以 会 
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有 众多 可 输入 项 目 。 

而 GitHub 是 一 款 为 软件 开发 者 提供 支持 的 工具 ， 与 项 目 管理 工具 
相 比 ， 它 更 注重 辅助 开发 者 高 速 开发 高 品质 软件 。 要 知道 ， 往 往事 物 越 
是 简单 ， 人 们 实施 起 来 就 越 快 。 

在 这 里 ， 笔 者 要 向 准备 使 用 GitHub 的 各 位 开发 者 提 个 建议 。GitHub 
本 身 相 较 于 各 位 正在 使 用 的 项 目 管理 工具 确实 会 有 功能 方面 的 不 足 。 但 
是 ， 先 不 要 急 着 用 其 他 工具 来 强行 弥补 ， 不 妨 试 着 大 胆 放弃 这 些 功 能 。 

GitHub 的 这 些 简单 功能 ， 完 全 能 够 应 对 软件 开发 中 的 需要 。 想 让 
团队 最 大 限度 发 挥 实 力 ， 建 议 剔除 复杂 规则 ， 只 以 最 简单 的 规则 进行 
开发 。 


















































@ 不 Fork 仓库 的 方法 


已 经 将 GitHub 利用 到 开源 软件 开发 中 的 读者 们 想必 会 以 下 面 的 流 
程 进行 Pull Request。 

















O 在 GitHub 上 进行 Fork 

© 将 @ 的 仓库 clone 至 本 地 开发 环境 

在 本 地 环境 中 创建 特性 分 支 

O 对 特性 分 支 进行 代码 修改 并 进行 提交 

日 将 特性 分 支 push 到 @ 的 仓库 中 

O FE GitHub 上 对 Fork 来 源 仓 库 发 送 Pull Request 























在 无 法 给 不 特定 的 多 数 人 赋予 提交 权限 的 公开 软件 开发 中 ， 这 种 流 
程 能 够 防止 仓库 收 到 计划 之 外 的 提交 。 

然而 在 公司 企业 的 开发 中 ,开发 者 每 天 都 要 见面 ， 要 经 常 互 相 发 送 
Pull Request， 这 种 流程 就 显得 有 些 繁琐 了 。 因 此 ， 下 面 我 们 要 介绍 一 个 
不 需要 Fork 仓库 的 工作 流程 。 这 种 方法 可 以 让 每 一 名 开发 者 都 掌握 着 
一 个 本 地 仓库 和 一 个 远程 仓库 ， 使 整个 开发 流程 变 得 简单 ( 图 9.3 )。 
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图 9.3 ”不 进行 Fork 的 开发 流程 





GitHub 
[s] 2^" Request 


push push 
pull pull 
[sc] («c 


发 者 A 开发 者 B 


























心 的 开发 模式 








下 面 我 们 为 各 位 讲解 GitHub 公司 正在 实践 的 一 个 十 分 简单 的 开发 
流程 (图 9.4) "。 


图 9.4 GitHub Flow 的 概要 

















master 


Pull Request 


branch 











这 是 一 个 以 部 署 ” 为 中 心 的 开发 流程 。 在 实际 开发 中 往往 1 天 之 内 
会 实施 几 十 次 部 署 ， 而 支撑 这 一 切 的 ， 就 是 足够 简单 的 开发 流程 以 及 完 
全 的 自动 化 。 简 单 的 开发 流程 能 够 让 问题 应 对 变 得 更 加 灵活 。 正 在 使 用 
GitHub 的 各 位 ， 请 务必 尝试 这 一 开发 流程 。 

















(D http://zachholman.com/talk/how-github-uses-github-to-build-github/ 
© 即 在 正式 环境 中 配置 源 代码 并 试 运行 。 
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正 因为 这 一 开发 流程 十 分 简单 ， 所 以 无 论 大 小 团队 都 可 以 取得 不 错 
的 效果 。 在 GitHub 公司 ， 大 致 会 让 15 至 20 人 组 成 团队 ， 利 用 这 一 流 
程 进行 同一 项 目的 开发 "。 以 笔者 的 经 验 ， 由 20 人 左右 的 团队 使 用 这 个 
流程 来 共同 开发 一 个 项 目 ， 基 本 不 会 出 现 什 么 大 问题 。 




















9.3 GitHub Flow 的 流程 





整个 开发 流程 大 致 如 下 。 


O S master 分 支 时 常 保持 可 以 部 署 的 状态 

O 进行 新 的 作业 时 要 从 master 分 支 创建 新 分 支 ， 新 分 支 名 称 要 具有 
描述 性 

在 @ 新 建 的 本 地 仓库 分 支 中 进行 提交 

O 在 GitHub 端 仓库 创建 同名 分 支 ， 定 期 push 

日 需要 帮助 或 反馈 时 创建 Pull Request， 以 Pull Request 进行 交流 

@ 让 其 他 开发 者 进行 审查 ， 确 认 作业 完成 后 与 master 分 支 合 并 

O 与 master 分 支 合并 后 立刻 部 署 



























































以 上 便 是 这 一 流程 的 全 部 内 容 。 由 于 流程 中 基本 只 需 为 特定 作业 创建 
特定 分 支 ， 从 开始 作业 到 进行 部 署 之 间 的 过 程 十 分 简单 ， 可 以 降低 开发 者 
学 习 开 发 流程 的 成 本 。 而 且 正 由 于 其 简单 ， 所 以 大 量 开发 者 可 以 迅速 将 其 
利用 到 开发 之 中 ， 并且 可 以 借助 它 来 灵活 处 理 一 些 细微 的 代码 变更 。 

下 面 我 们 按 顺序 一 步 步 进行 讲解 。 






































@ 随时 部 署 ， 没 有 发 布 的 概念 


这 个 流程 必须 遵守 “ 令 master 分 文 随时 保持 可 以 部 署 的 状态 ”这 一 规 
则 。 每 隔 几 小 时 进行 一 次 部 署 ， 可 以 有 效 防 止 同时 出 现 多 个 严重 BUG, 








(D http://scottchacon.com/2011/08/31/github-flow.html 
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虽然 有 时 仍 会 有 一 些小 BUG 出 现 ， 但 只 要 将 相应 的 提交 revert 或 





者 提交 修正 过 的 代码 即 可 轻松 应 对 。 这 一 流程 要 以 小 时 其 至 分 钟 为 单位 








创建 





持续 地 进行 部 署 ， 所 以 不 存在 发 布 的 概念 。 因 此 ， 不 会 出 现 让 HEAD 返 
回去 





指向 很 久之 前 的 提交 ”"， 借 以 取消 整个 作业 内 容 的 情况 。 
| F master 分 支 时 常 保持 着 可 以 部 署 的 状态 ， 所 以 开发 者 可 以 随时 
新 的 分 支 。 


























要 注意 ， 没 有 进行 过 测试 或 者 测试 未 通过 的 代码 绝 不 可 以 合并 到 











master 分 支 。 因 此 势必 要 用 到 持续 集成 等 手段 。 











e 进行 新 的 作业 时 要 从 master 分 支 创 建新 分 支 





进行 新 的 作业 时 要 从 master 分 支 创 建新 分 支 ， 无 论 是 添加 新 功能 还 

















是 修复 BUG 都 是 如 此 。 此 外 ， 新 分 支 的 名 称 要 具有 描述 性 。 





特性 ， 

















所 谓 具 有 描述 性 的 名 称 ， 是 指 该 名 称 能 直观 正确 地 表达 这 个 分 支 的 
比如 以 下 几 种 。 

















* user-content-cache-key 
* submodules-init-task 


* redis2-transition 








其 他 开发 者 可 以 通过 这 些 名 字 清 楚 地 了 解 到 该 分 支 正 在 进行 什么 














工作 。 


采用 这 一 方式 ， 开 发 者 在 查看 远程 仓库 的 分 支 列 表 时 ， 能 够 对 当前 








团队 正在 实施 的 任务 一 目 了 然 。 男 外 ， 由 于 分 支 名 明确 描述 了 工作 内 
容 ， 即 便 开发 者 需要 先 去 做 其 他 工作 ， 回 来 时 也 能 很 快 想起 该 分 支 的 工 


作 目 标 。 




















查看 GitHub 的 分 支 列表 页 面 ” 还 可 以 轻松 掌握 各 分 支 与 master 分 支 








的 差别 。 





(D 相当 于 Git 的 git reset 命令。 
Q) https://github.com/ 用 户 名 /仓库 名 /branches 
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@ 在 新 创建 的 分 支 中 进行 提交 


在 前 面 的 步骤 中 ， 开 发 者 为 了 进行 新 的 更 改 而 创建 了 新 分 支 ， 并 且 
明确 了 在 这 个 分 支 中 应 该 做 哪些 工作 。 接 下 来 就 可 以 在 这 个 分 支 中 修改 
代码 ， 并 进行 提交 了 。 修 改 代码 时 要 注意 ， 绝 对 不 能 进行 与 该 分 支 工作 
内 容 无 关 的 修改 。 

在 这 一 阶段 ， 开 发 者 要 在 提交 的 粒度 上 多 花心 思 。 有 意识 地 减 小 提 
交 的 规模 ， 一 方面 便于 清楚 地 表达 目的 ， 男 一 方面 有 助 于 其 他 开发 者 对 
Pull Request 进行 审查 。 

比如 在 添加 一 个 方法 时 ， 确 认 添 加 位 置 以 及 类 之 后 ， 开 发 者 往往 还 
需要 进行 下 面 的 操作 。 




















D 







































































。 修正 附近 代码 的 缩 进 问题 
。 发 现 变 量 单词 拼写 错误 并 进行 修正 
。 添加 本 次 作业 中 需要 添加 的 方法 

















如 果 将 上 述 工作 在 一 次 提交 中 完成 ， 那么 一 个 差别 将 包含 3 种 含 
义 ， 这 种 提交 的 粒度 就 有 些 不 妥 。 如 果 将 3 个 工作 分 为 3 次 提交 ,那么 
每 个 差别 就 有 了 更 清晰 的 含义 。 

在 分 支 中 修改 代码 与 发 送 提交 时 只 需 注意 以 上 几 点 ， 其 余 方 面色 可 
按照 往常 的 方式 进行 。 


I 


























0 定期 push 


在 这 一 开发 流程 中 ， 由 于 除了 master 分 支 之 外 都 是 作业 中 的 分 支 ， 
所 以 push 作业 分 支 时 不 需要 有 太 多 顾虑 。 在 开发 过 程 中 ， 建 议 开发 
者 定期 将 本 地 仓库 中 创建 的 分 支 以 同名 形式 push 到 GitHub 端的 远程 
仓库 。 

这 样 一 来 不 仅 可 以 备份 代码 ， 还 会 定期 给 开发 者 团队 创造 交流 的 机 
会 。 其 他 开发 者 在 做 什么 工作 ， 是 否 需 要 帮助 等 ， 团 队 成 员 可 以 通过 
GitHub 的 分 支 列 表 页 面 一 目 了 然 。 
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在 开发 过 程 中 ， 最 好 让 其 他 开发 者 能 够 看 到 自己 编写 的 代码 ， 同 时 
养 成 积极 查看 其 他 人 代码 的 习惯 。 通 过 代码 进行 交流 是 开发 者 的 特权 ， 
我 们 没有 理由 不 去 利用 。 














e 使 用 Pull Request 


Pull Request 不 一 定 非 要 在 与 master 分 支 合 并 时 才 使 用 。 既 然 是 团 
队 开 发 ， 完 全 可 以 尽早 创建 Pull Request 让 其 他 开发 者 进行 审查 ， 一 边 
听取 反馈 一 边 编写 代码 ， 没 必要 等 到 与 master 分 支 合并 时 再 进行 。 

Pull Request 具有 显示 差别 以 及 对 单行 代码 插入 评论 的 功能 ， 开 发 者 
可 以 利用 这 些 进行 交流 。 另 外 ， 如 果 和 希望 得 到 特定 开发 者 的 反馈 或 建 
议 ， 可 以 在 评论 中 加 入 “@ 用 户 名 ”， 给 该 用 户 发 送 Notifications。 对 方 
注意 到 之 后 ， 照 例 都 会 以 某 种 形式 进行 反馈 。 



































@ 务必 让 其 他 开发 者 进行 审查 

一 个 分 支 的 作业 结束 后 ， 需 要 注 明 作业 已 完成 ， 让 其 他 开发 者 进行 
审查 。 找 其 他 开发 者 看 一 看 自己 编写 的 代码 ， 可 以 有 效 防 止 想当然 的 错 
误 或 者 低级 失误 。 审 查 时 要 选择 没有 参与 编写 的 人 ， 被 指出 有 问题 时 ， 
要 积极 进行 修改 。 当 然 ， 这 一 切 的 大 前 提 是 该 部 分 代码 已 经 通过 所 有 自 
动 测 试 。 
审查 之 后 如 果 认 为 可 以 与 master 分支 合并 ， 则 需要 明确 地 告知 对 
方 。 按 照 GitHub 的 文化 ， 这 里 会 用 到 “:+1:” 或 “:shipit:” 等 表情 (图 
9.5 ), 偶尔 也 会 见 到 LGTM 的 字样 ， 这 是 Looks good to me 的 简写 。 

征 得 多 个 人 同意 后 ， 便 可 找 个 适当 的 时 机 让 其 他 开发 者 将 该 分 支 与 
master 分 支 进行 合并 。 

































































@ 合并 后 立刻 部 署 
代码 合并 至 master 分 支 并 且 通 过 所 有 自动 测试 之 后 ， 需 要 立刻 进行 
部 署 。 在 部 署 之 后 ， 需 要 确认 刚刚 合并 的 代码 是 否 存在 问题 。 
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9.5 “通过 表情 表达 意见 


Q EE commented a year ago 


If using capistrano with multistage and set deploy to variable in deploy/production.rb and 





deploy/staging.rb ,then current path On unicorn's tasks will be  /u/apps/... . Maybe it's 
capistrano's bug, but this PR fixes that. 


Also, removed some rescue calls. 


lk fixed current. path fetching 


memme commented a year ago 


please merge this, | have the same issue 


"n xim commented a year ago 


+1 


meum. commented a year ago 


+1 


hirocaster commented a year ago 


ga 


di 


EE commented 11 months ago 


+1 











9.4 实践 GitHub Flow 的 前 提 条 件 


至 此 ， 相 信 各 位 已 经 对 这 一 开发 流程 有 了 大 体 印象 。 接 下 来 我 们 需 
要 考虑 实践 这 一 开发 流程 所 需 的 前 提 条 件 。 





e 部 署 作业 完全 自动 化 


首先 ， 部 署 的 相关 作业 必须 实现 自动 化 。 这 一 开发 流程 在 一 天 当中 
需要 多 次 部 署 ， 以 旧 有 开发 模式 按 部 署 文档 进行 部 署 作 业 会 浪费 相当 多 
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的 时 间 ， 同 时 还 很 可 能 发 生 操 作 失 误 ， 作 为 一 名 程序 员 ， 不 应 该 每 天 为 
这 些 工作 花费 精力 。 





o- 使 用 部 署 工具 


于 是 ,我 们 要 使 用 Capistrano 等 部 署 工具 ， 让 部署 时 所 需 的 一 系列 
流程 自动 化 。 一 旦 实现 自动 化 ， 部 署 工作 就 能 够 简化 成 一 条 指令 ， 同 时 
大 幅 减 少 粗 心 大意 导 致 的 人 为 失误 ， 让 所 有 参与 开发 的 人 都 能 够 放心 地 
实施 部 署 工作 。 

另外 ， 这 类 部 署 工具 都 有 回 滚 功 能 。 不 小 心 部 署 了 有 问题 的 代码 
时 ， 只 需 一 条 指令 就 可 以 将 版 本 回 深 至 部 署 之 前 。 为 此 ， 最 好 让 所 有 参 
与 开发 的 人 都 能 进行 回 深 操 作 。 
显而易见 ， 只 需 将 以 往 用 来 编写 操作 顺序 手册 和 进行 维护 的 时 间 拿 
出 一 点 来 编写 部 署 工具 的 代码 ， 就 可 以 换 来 众多 好 处 。 






































e- 通过 Web 界面 进行 部 署 的 工具 














Capistrano 等 部 署 工具 需要 使 用 命令 行 执行 操作 ， 开 发 者 以 外 的 人 
很 难 实施 部 署 。 而 Webistrano 和 Strano 等 工具 则 提供 了 通过 Web 执行 
部 署 指令 的 界面 ， 能 够 帮助 团队 成 员 解 决 这 个 问题 。 一 个 团队 除了 开发 
者 以 外 ,往往 还 包含 美工 或 HTML 编辑 等 人 ， 在 开发 过 程 中 ， 创 建 一 个 
让 团队 所 有 相关 人 员 都 能 放心 部 署 的 环境 至 关 重 要 。 表 9.1 中 列 出 了 几 
种 具有 代表 性 的 部 署 工 具 。 







































































表 9.1 ”具有 代表 性 的 部 署 工具 













































































名 称 URL 备注 

Capistrano https://github.com/capistrano/capistrano | Ruby 开发 的 代表 性 部 署 工具 

Mina https://github.com/nadarei/mina Ruby 开发 的 部 署 工具 

Fabric http://fabfile.org/ Python 开发 的 部 署 工具 

Cinnamon https://github.com/kentaro/cinnamon Perl 开发 的 部 署 工具 

Webistrano* | https://github.com/kentaro/webistrano | 可 通过 Web 执行 Capistrano 
的 工具 

Strano https://github.com/joelmoss/strano 可 通过 Web 执行 Capistrano 














的 工具 ， 与 Webistrano 采 
的 中 间 件 不 同 





























K 由 于 开发 方 已 经 停止 开发 ， 这 里 仅 介绍 Fork 版 。 
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e 导入 开发 时 的 注意 事项 


随 着 团队 人 数 增多 以 及 成 熟 度 提高 ， 开 发 速度 会 越 来 越 快 。 这 时 往 
往 一 个 部 署 尚未 完成 ， 另 一 名 开发 者 就 已 经 处 理 完 下 一 个 Pull Request, 
开始 实施 下 一 个 部 署 了 。 在 这 种 情况 下 ， 一 旦 正式 环境 中 出 现 问题 ， 很 
难 分 辨 是 哪个 部 署 造 成 的 影响 。 为 了 应 对 这 种 情况 ， 建 议 在 部 署 实施 过 
程 中 通过 工具 上 锁 ， 或 者 在 实施 部 署 时 通知 整个 团队 等 ， 通 过 严格 贯彻 
这 类 规则 来 消除 隐患 。 






































e 重视 测试 
e@…… 让 测试 自动 化 


如 果 每 次 部 署 到 正式 环境 前 都 需要 在 测试 环境 中 手动 进行 测试 , JE 
这 一 开发 流程 也 就 无 从 谈 起 了 。 所 以 必须 让 测试 自动 化 , 令 其 自动 检测 
是 否 有 代码 被 意外 破坏 ， 以 及 是 否 出 现 BUG。 











e 编写 测试 代码 ， 通 过 全 部 测试 


每 一 名 开发 者 都 必须 编写 测试 代码 。 成 品 代 码 的 Pull Request 中 如 
果 不 包 含 测试 代码 ， 是 不 可 以 合并 至 master 分 支 中 的 。 只 有 包含 测试 代 
码 并 且 通 过 了 所 有 测试 的 成 品 代码 才 可 以 被 合并 至 master 分 支 。 

开发 者 确认 代码 在 本 地 环境 中 通过 了 所 有 测试 后 ， 将 其 push 到 远 
程 仓库 。 随 后 Jenkins 或 Travis CI 等 CI 工具 会 自动 对 其 进行 测试 ， 测 试 
结果 由 CI 工具 第 一 时 间 通 知 开发 者 。 经 过 这 一 流程 ， 系 统 能 够 自动 检 
测 出 软件 是 否 遭 到 破坏 。 我 们 在 8.6 节 中 已 经 详细 讲解 过 如 何 构建 与 
GitHub 集成 的 Jenkins 环境 ， 各 位 可 加 以 参考 。 












































o- 维护 测试 代码 

要 注意 的 是 ， 测 试 代码 必须 时 常 进行 维护 ， 以 保证 能 够 在 开发 流程 
可 承受 的 速度 范围 内 完成 所 有 测试 。 顺 便 一 提 ，GitHub 公司 可 以 在 200 
秒 内 实施 14 000 个 自动 测试 ”。 这么 短 的 时 间 内 完成 如 此 多 的 测试 项 目 ， 











(D http://zachholman.com/posts/how-github-works/ 
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效率 实在 惊人 。 








这 一 工作 流程 以 部 署 为 中 心 ， 通 过 简单 的 功能 和 规则 ， 持 续 且 高 速 
安全 地 进行 部 署 。 至 此 相信 各 位 都 已 经 有 了 一 定 程度 的 理解 。 

不 论 是 添加 新 功能 还 是 修正 小 BUG， 全 都 通过 同一 流程 进行 。 它 
的 高 效 正 源 于 它 的 简单 。 从 结果 上 看 ,简单 的 构造 让 这 一 开发 流程 兼 具 
了 高 速度 与 灵活 性 。 

各 位 不 妨 也 让 自己 的 团队 试 着 采用 这 一 开发 流程 。 






























































9.5 ”模拟 体验 GitHub Flow 





通过 前 面 的 讲解 ， 各 位 对 开发 者 实施 GitHub Flow 的 步骤 应 该 有 了 一 
个 具体 的 了 解 。 现 在 就 让 我 们 一 起 来 结合 GitHub 上 的 交流 体验 这 一 流程 。 
现在 假设 各 位 是 负责 给 某 软件 开发 功能 的 开发 者 ， 并 且 所 在 团队 正 
在 实践 GitHub Flow。 账 户 名 为 ituring， 仓 库 名 为 fizzbuzz。 我 们 即将 讲 
解 的 软件 已 经 公开 了 代码 ， 请 各 位 将 其 仓库 Fork 至 自己 的 GitHub 账户 
下 ,与 我 们 一 起 动手 尝试 。 
下 面 我 们 将 “Fizzbuzz 问题 ” 作为 编程 的 题材 。 

































































@ Fizzbuzz 的 说 明 


假设 我 们 的 团队 已 经 开发 了 一 款 名 叫 Fizzbuzz 的 软件 。 
这 一 软件 在 输出 1 至 100 的 数字 时 会 如 下 显示 。 





e 3 的 倍数 时 显示 fizz 

e 5 的 倍数 时 显示 buzz 

*3 与 5 的 公 倍数 时 显示 fizzbuzz 
。 除 上 述 情况 外 直接 显示 数字 











(D http://en.wikipedia.org/wiki/Fizz_buzz 
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就 是 这 样 一 个 简单 的 软件 。 


$ ruby exec.rb 


Ta 

fizz 

13 

14 
fizzbuzz 


省 略 

现在 就 来 讲解 我 们 作为 这 个 软件 开发 团队 的 一 员 ， 实 践 GitHub 
Flow 时 的 情景 。 
e 添加 新 功能 

现在 我 们 被 分 配 了 新 工作 ， 那 就 是 添加 下 面 这 个 新 功能 。 

e 含有 7 的 数字 时 显示 GitHub 


看 起 来 应 该 很 简单 ， 我 们 这 就 动手 吧 。 


e 创建 新 的 分 支 

在 GitHub Flow 中 ， 无 论 是 实现 新 功能 还 是 修正 BUG， 都 需要 从 能 
正常 运行 的 最 新 master 分 支 中 新 建 一 个 分 支 。 所 有 实际 修改 都 在 这 个 新 
建 的 分 支 中 进行 。 
e 如 果 尚 未 clone 仓库 

首先 需要 Fork 已 经 公开 的 仓库 ”。 如 果 尚 未 获取 仓库 ， 则 需要 使 用 











(D https://github.com/ituring/fizzbuzz 
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下 面 的 命令 进行 clone。 各 位 请 将 仓库 路 径 替 换 为 自己 的 对 应 路 径 。 


$ git clone git@github.com:ituring/fizzbuzz.git 











Cloning into 'fizzbůzz'.s. 

remote: Counting objects: 18, done. 

remote: Compressing objects: 100$ (12/12), done. 
remote: Total 18 (delta 2), reused 17 (delta 1) 
Receiving objects: 100$ (18/18), done. 
Resolving deltas: 100$ (2/2), done. 

$ cd fizzbuzz 


在 人 izzbuzz 目录 下 新 建 了 一 个 仓库 ， 这 个 仓库 与 远程 仓库 拥有 相同 





T 








i 


e@…… 如 果 之 前 clone 过 仓库 


假设 本 地 已 经 有 之 前 clone 来 的 仓库 ， 现 在 正在 开发 途中 并 不 需要 
重新 clone， 那 么 我 们 应 该 将 master 分 支 更 新 成 远程 仓库 最 新 master 分 
支 的 状态 。 流 程 很 简单 ， 只 需 切 换 到 本 地 仓库 的 master 分 支 ， 然 后 将 远 
程 仓库 的 master 分 支 pull 到 本 地 即 可 。 


$ git checkout master 











Switched to branch 'master' 
$ git pull 


First, rewinding head to replay your work on top of it... 
Fast-forwarded master to 51412d2d518af30deaa8fd5e6469c9376ee1f447. 


通过 以 上 操作 ， 我 们 手头 就 有 了 最 新 状态 的 master 分 支 。 
@…… 创建 特性 分 支 


现在 我 们 已 经 完成 了 从 master 分 文 创 建新 分 支 的 所 有 准备 工作 。 我 
们 将 新 分 支 的 名 字 定 为 7-case-output-github。 
在 master 分 支 中 使 用 下 述 命 令 创 建新 分 支 ， 并 切换 到 新 分 支 。 


$ git checkout -b 7-case-output-github 




















Switched to a new branch '7-case-output-github' 


为 方便 团队 其 他 人 通过 分 文 名 称 知道 我 们 在 做 什么 ， 我 们 在 GitHub 
端的 远程 仓库 中 创建 一 个 同名 分 支 。 
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$ git push -u origin 7-case-output-github 

Total 0 (delta 0), reused 0 (delta 0) 
To gitegithub.com:ituring/fizzbuzz.git 

* [new branch] 7-case-output-github -» 7-case-output-github 
Branch 7-case-output-github set up to track remote branch 7-case-output 
-github from origin. 





创建 分 支 大 概 就 是 这 个 步 又。 今后 我 们 可 以 每 当 工 作 告 一 段落 时 ， 
定期 将 这 个 特性 分 支 push 到 远程 仓库 。 




















@ 实现 新 功能 


现在 我 们 来 实现 新 功能 
( fizzbuzz.rb ) 如 下 ， 





含有 数字 7 时 显示 GitHub。 原 本 的 代码 





class Fizzbuzz 
def calculate number 
if number $ 3 -- 0 && number $ 5 == 0 
'fizzbuzz' 
elsif number $ 3 -- 0 
ERU 
elsif number $ 5 -- 0 
'buzz' 
else 
number 
end 
end 


end 


现在 我 们 添加 含有 数字 7 时 的 代码 ，di 芷 如 下 。 


@@ -6,6 +6,8 @@ class Fizzbuzz 
Iriz! 
elsif number $ 5 == 0 
liu za 
* elsif number.to s.include? '7' 
十 'GitHub' 
else 
number 
end 


我 们 试 着 执行 一 下 ， 结 果 运 行 正常 。 


$ ruby exec.rb 
d 
2 
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4 
buzz 
fizz 

GitHub 


fizzbuzz 
6 
GitHub 





提交 本 次 实现 的 内 容 。 


$ git commit -am "Add output GitHub" 
[7-case-output-github 676c64d] Add output GitHub 
1 file changed, 2 insertions (+) 


新 功能 已 经 顺利 实现 ， 现 在 将 其 push 到 远程 仓库 。 


$ git push 
Counting objects: 7, done. 
Delta compression using up to 8 threads. 
Compressing objects: 100$ (3/3), done. 
Writing objects: 100% (4/4), 385 bytes, done. 
Total 4 (delta 2), reused 0 (delta 0) 
To gitGgithub.com:ituring/fizzbuzz.git 
ca9ebf6..676c64d  "7-case-output-github -> 7-case-output-github 


GitHub 端 远程 仓库 中 的 分 支 应 该 已 经 被 更 新 。 我 们 打开 GitHub 的 
分 支 列表 页 面 ， 能 看 到 该 远程 分 支 与 master 1 5c 82859] (图 9.6 )。 点 击 
之 后 可 以 查看 差别 的 详细 内 容 。 


图 9.6 分支 列表 页 面 


























Ẹ branch: master ~ Files Commits ^ Branches 2 Tags 


Branches 
Showing 1 branch not merged into master. View merged branches. 


Recenty active EREEEER Stale 


master Base branch 
hirocaster. 


7-case-output-github — Ẹ Delete branch — [f] Compare 
0 behind 


Last updated 5 minutes ago by hirocaster. 

















图 灵 社 区 会 员 lxghost2 *zzz 尊重 版 权 






































196 | 第 9 章 使 用 GitHub 的 开发 流程 





@ 创建 Pull Request 


至 此 ， 我 们 已 经 顺利 实现 了 新 功能 ， 接 下 来 就 是 从 7-case-output- 
github 分 支 创建 一 个 Pull Request 发 送 给 master 分 支 ， 请 求 与 master 合 
Jf (图 9.7) ", 创建 Pull Request 的 相关 操作 请 参照 第 6 章 。 











9.7 向 master 分 支 发 送 的 Pull Request 


hirocaster commented 11 months ago 


* 含有 数字 7 时 显示 GitHub 











E] Add output GitHub [oO 








在 Pull Request 中 写 明 希望 得 到 审查 。 如 果 想 让 特定 的 人 来 进行 
查 ， 可 以 在 评论 中 加 入 “@ 用 户 名 ”， 这 样 该 用 户 就 会 收 到 Notifications。 

现在 我 们 已 经 创建 并 发 送 了 Pull Request， 只 需 等 待 其 他 开发 者 的 反 
馈 即 可 。 




















@ 接收 反馈 

距离 发 送 Pull Request 已 经 过 了 几 个 小 时 ， 我 们 再 次 登录 GitHub, 
此 时 已 有 其 他 开发 者 已 经 发 来 了 反馈 ( 图 9.8 )。 

对 方 为 我 们 指出 了 2 个 问题 。 











。 缩 进 不 正常 
。 没有 测试 代码 


点 击 “ 缩 进 好 像 不 太 对 ”所 指 的 链接 ， 我 们 可 以 看 到 如 图 9.9 所 示 
的 页 面 ， 其 中 清楚 地 显示 出 评论 所 指 代码 的 位 置 。 确 实 与 前 面 elsif 的 缩 
进 没 有 对 齐 。 


















































(D Pull Request 在 创建 时 会 默认 指向 Fork 来 源 的 仓库 ， 由 于 本 书 在 获取 示例 仓库 时 进 
行 了 Fork， 所 以 这 里 我 们 需要 更 改 目 标 仓库 的 路 径 。 正 式 采 用 GitHub Flow 的 开发 
现场 是 不 需要 进行 Fork 操作 的 ， 所 以 在 实际 应 用 中 不 需要 修改 目标 路 径 的 操作 。 
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图 9.8 ”其 他 开发 者 的 反馈 


hirocaster commented 11 months ago 


“含有 数字 7 时 显示 GitHub 





已 经 实现 。 求 审查 。 
E Add output GitHub 


» yurla commented on 676c64d 1ib/fizzbuzz.rb:L9 11 months ago "MC 
缩 进 好 像 不 太 对 。 


» yuria commented 11 months ago © 


没有 关于 本 次 实现 的 测试 代码 ， 请 添加 一 份 。 














图 9.9 被 评论 代码 所 在 的 位 置 





2mm lib/fizzbuzz.rb (M show inline notes View 


ee -6,6 +6,8 @ def calculate number 
'fizz' 
elsif number $ 5 == 0 
"buzz' 


elsif number.to s.include? '7' 
pi 注 yuria added a note 11 months ago ZEE 


缩 进 好 像 不 太 对 。 


Add a line note 


'GitHub' 
else 
number 
end 











至 于 测试 代码 ， 我 们 确实 在 添加 新 功能 时 没有 添加 相应 的 测试 代 
码 ， 对 方 指出 的 问题 确实 存在 。 接 下 来 ,我们 要 着 手 处 理 这 2 个 问题 。 


@ 修正 缩 进 














下 面 ， 我 们 来 修正 对 方 指出 的 代码 缩 进 问题 。 修 正 后 的 diff A P 
所 示 。 


@@ -6,7 +6,7 @@ class Fizzbuzz 
(EL 
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elsif number $ 5 -- 
"buzz! 
= elsif number.to s.include? '7' 
* elsif number.to s.include? '7' 
'GitHub' 
else 
number 


然后 将 修改 提交 至 本 地 的 7-case-output-github 分 支 。 


$ git commit -am "Fix indent" 
[7-case-output-github fi15fe2e] Fix indent 
1 file changed, 1 insertion(«), 1 deletion(-) 


接 下 来 将 该 分 支 push 到 GitHub 端的 远程 仓库 ， 为 远程 仓库 分 支 添 
加 这 项 修改 。 


$ git push 
Counting objects: 7, done. 
Delta compression using up to 8 threads. 
Compressing objects: 100% (3/3), done. 
Writing objects: 100$ (4/4), 335 bytes, done. 
Total 4 (delta 2), reused 0 (delta 0) 
To gitógithub.com:github-book/fizzbuzz.git 
676c64d..fl5fe2e  7-case-output-github -> 7-case-output-github 








这 时 我 们 再 打开 GitHub 查看 Pull Request， 会 发 现 这 个 用 于 修正 的 
提交 已 经 添加 至 Pull Request ( 图 9.10 )。 


9.10 “ 缩 进 的 修正 已 经 添加 至 Pull Request 


hirocaster commented 11 months ago 


* 含有 数字 7 时 显示 GitHub 


已 经 实现 。 求 审查 。 





Add output GitHub r] 
» yurla commented on 676c64d 1ib/fizzbuzz.rb:L9 11 months ago f 四 
缩 进 好 像 不 太 对 。 


» yuria commented 11 months ago f © 


没有 关于 本 次 实现 的 测试 代码 ， 请 添加 一 份 。 





I] rix indent 
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在 GitHub Flow 中 ， 不 可 以 将 没有 测试 代码 的 成 品 代 码 加 入 master 
分 支 。 因 此 我 们 被 其 他 开发 者 指出 没有 编写 测试 代码 了 。 














一 般 来 说 应 该 是 下 面 这 样 的 顺序 。 











* 将 master 分 支 更 新 到 最 新 状态 














。 在 自己 的 开发 环境 中 古 




















认 通 过 所 有 测试 


e 从 master 分 支 创 建新 分 支 





。 编写 测试 代码 





。 编写 实现 目标 功能 的 代码 














e. 确认 通过 所 有 测试 并 且 没 有 出 现 退 步 (Regression ) 现象 
e 发 送 Pull Request 请 求 合并 至 master 分 支 














也 就 是 应 该 先 编写 目标 功能 的 测试 代码 ， 以 保证 测试 代码 全 部 通过 
为 基准 编写 功能 代码 。 这 个 操作 顺序 能 够 极力 减少 出 现 BUG 的 可 能 ， 

















并 且 可 以 随时 修改 功能 代码 。 

















1 于 本 次 我 们 直接 编写 了 功能 的 功能 代 




















码 ， 所 以 需要 回 过 头 来 再 为 其 添加 一 份 测试 代码 。 
根据 已 有 的 测试 代码 为 本 次 实现 的 功能 编写 测试 代码 时 ， 我 们 突然 


有 了 一 个 疑问 。 














例如 75 这 个 数字 ， 它 既是 3 的 倍数 也 是 5 的 倍数 ， 按 照旧 功能 会 

















显示 为 fizzbuzz， 那 么 在 添加 新 功能 后 它 应 该 显示 为 GitHub Hj? 还 是 说 





应 该 显示 成 fizzbuzzGitHub 这 种 组 合 形式 呢 ? 关于 这 种 情况 我 们 并 没有 
接 到 说 明 ， 所 以 保险 起 见 ， 我 们 通过 Pull Request 确认 一 下 。 

在 Pull Request 中 写 下 如 图 9.11 所 示 的 评论 。 

不 入， 我 们 收 到 了 其 他 开发 者 的 反馈 ( 图 9.12 )。 

按照 反馈 的 指示 ， 我 们 在 fizzbuzz_spec.rb 中 添加 测试 代码 。 
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图 9.11 “通过 评论 询问 规范 





hirocaster commented 11 months ago 


@yuria 感谢 您 的 审查 。 


关于 功能 方面 有 个 问题 。 

比如 ， 在 本 次 实现 之 前 ， 数 字 75 应 该 显示 fizzbuzz。 

但 在 本 次 实现 后 ， 由 于 属于 “含有 数字 7” 的 范畴 ， 会 显示 成 GitHub。 
您 有 没有 想 过 让 它 显 示 成 fizzbuzzGitHub 这 种 复合 形式 呢 ? 
































图 9.12 ”对 规范 相关 问题 的 回答 





» yuria commented 11 months ago 


原来 如 此 ， 我 没有 想到 这 种 情况 。 
请 按照 以 下 规范 实现 。 


* 即便 是 3 或 者 5 的 倍数 ， 只 要 含有 数字 7 就 显示 GitHub 











context 'GitHub number' do 


it ( subject.calculate(17).should eq 'GitHub' ] 

it { subject.calculate(27).should eq 'GitHub' } 

it { subject.calculate(75).should eq 'GitHub' } 

it { subject.calculate(77).should eq 'GitHub' } 
end 




















我 们 添加 了 具有 以 下 意图 的 测试 。 


e 17 与 77 中 包含 7， 所 以 显示 GitHub 
e 27 虽然 是 3 的 倍数 ， 但 仍然 显示 GitHub 
e 75 既是 3 的 倍数 也 是 5 的 倍数 ， 但 仍然 显示 GitHub 








然后 执行 测试 。 


$ rspec 


Failures: 


1) Fizzbuzz GitHub number 
Failure/Error: it ( subject.calculate(27).should eq 'GitHub' 


expected: "GitHub" 


be 9) UdesLa 
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F 
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(compared using --) 
4 ./spec/fizzbuzz spec.rb:25:in "block (3 levels) in «top (required)> 


2) Fizzbuzz GitHub number 
Failure/Error: it ( subject.calculate(75).should eq 'GitHub' ] 


expected: "GitHub" 


got: EVE zv 


(compared using --) 
4 ./spec/fizzbuzz spec.rb:26:in "block (3 levels) in «top (required)> 


inished in 0.00373 seconds 


14 examples, 2 failures 


F 


24 
HS 


ailed examples: 


Spec ./spec/fizzbuzz spec.rb:25 # Fizzbuzz GitHub number 
Spec ./spec/fizzbuzz spec.rb:26 4 Fizzbuzz GitHub number 











IT 


从 上 面 我 们 可 以 看 到 ，27 5 75 时 并 没有 显示 GitHub， 因 此 代码 需 














要 进行 修正 。 修 正 后 的 差别 如 下 。 


[o] 


$ 


+ 





G -1,13 «41,13 09 
class Fizzbuzz 
def calculate number 


if number $ 3 -- 0 && number $ 5 -- 0 

if number.to s.include? '7' 
'GitHub' 

elsif number $ 3 -- 0 && number $ 5 -- 0 
tfizabuzz' 

elsif number $ 3 == 0 
LEIZA 

elsif number $ 5 == 0 


'buzz' 

elsif number.to s.include? '7' 
'GitHub' 

else 





number 
end 


我 们 将 判定 是 否 显示 GitHub 的 语句 换 了 个 位 置 。 这 段 代码 理 所 当 





然 地 通过 了 所 有 测试 。 


图 灵 社 区 会 员 lxghost2 专 享 尊重 版 权 





ly 
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$ ropese 


Finished in 0.00353 seconds 
14 examples, 0 failures 


至 此 ， 我 们 添加 了 测试 代码 ， 成 品 代码 也 能 按照 预期 顺利 执行 了 。 


e 培育 Pull Request 








为 了 将 我 们 编写 的 新 功能 合并 到 master 分 支 中 ， 要 进行 提交 并 
push。 


$ git commit -am "Fix output GitHub" 
[7-case-output-github 5dl1daae] Fix output GitHub 
2 files changed, 9 insertions(+), 3 deletions(-) 


$ git push 
Counting objects: 11, done. 
Delta compression using up to 8 threads. 
Compressing objects: 100% (4/4), done. 
Writing objects: 100$ (6/6), 531 bytes, done. 
Total 6 (delta 3), reused 0 (delta 0) 
To gitGgithub.com:ituring/fizzbuzz.git 
fl5fe2e..5dldaae  7-case-output-github -> 7-case-output-github 














确认 Pull Request 没有 问题 之 后 ， 便 可 以 通过 评论 请 求 与 master £r 
并 了 (图 9.13 )。 
这 一 系列 反馈 与 代码 更 新 的 过 程 ， 我 们 称 作 培育 Pull Request。 

















9.13 Æ Pull Request 中 添加 评论 





Fix output GitHub 


hirocaster commented 11 months ago 


测试 代码 已 经 添加 ， 新 功能 也 已 实现 。 
审查 后 如 无 问题 请 进行 合并 。 














@ Pull Request 被 合并 
随后 ， 我 们 的 代码 通过 了 其 他 开发 者 的 审查 ， 被 顺利 合并 至 master 
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分 支 ( 图 9.14 )。 


图 9.14 


被 合并 至 master 分 支 后 的 情景 





» yurla commented 11 months ago f G 


d 


A QM yurla referenced this pull request from a commit 11 months ago 


MÀ Merge pull request #1 from github-book/7-case-output-github = 


Q Ņ yuria merged commit 4476349 into master from 7-case-output-github 11 months ago 








Q if yuria closed the pull request 11 months ago 








合并 完成 后 ， 这 个 master 分 支 将 被 立刻 部 署 至 正式 环境 "。 








通过 创建 Pull Request 获取 反馈 并 逐渐 培育 Pull Request 的 过 程 想必 








各 位 已 经 有 了 初步 的 了 解 。 在 实际 开发 现场 ,会 有 更 多 开发 者 共同 参与 
到 这 个 交流 过 程 中 。 
习惯 了 在 Pull Request 上 进行 交流 后 ， 我 们 将 能 更 精确 地 表达 出 代 





























码 的 意图 ， 











查 的 效率 也 会 越 来 越 快 。 熟 练 运用 Pull Request 是 这 一 开 





发 流程 成 功 的 关键 。 
希望 各 位 能 将 这 一 开发 流程 应 用 到 自己 的 开发 现场 ， 以 便 更 加 灵活 
地 使 用 GitHub。 








9.6 团队 实践 GitHub Flow 时 的 几 点 建议 


至 此 ， 相 信 各 位 已 经 清楚 GitHub Flow 需要 以 什么 样 的 流程 来 实施 。 
但 是 在 开发 现场 实际 采用 这 一 流程 时 ， 还 会 遇 到 一 些 令 人 苗 恼 的 问题 。 
在 这 里 ， 笔 者 将 从 自身 经 验 出 发 ， 为 各 位 介绍 几 个 成 功 运用 这 一 开发 流 


ERS] 





这 一 系列 交流 可 以 在 GitHub 上 阅览 。 
https://github.com/ituring/fizzbuzz/pull/1 
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0 减 小 Pull Request 的 体积 


很 多 团队 在 开发 时 ， 喜 欢 将 一 个 功能 放 到 一 个 分 支 中 进行 开发 。 
里 各 位 不 妨 思考 一 下 ， 这 一 个 功能 是 不 是 还 能 继续 细 分 ? 

比方 说 接 下 来 的 一 个 新 功能 我 们 预计 要 花 2 周 来 实现 。 试 想 一 下 ， 
大 约 2 周 时 间 编 写 出 来 的 代码 ， 即 便 最 后 顺利 进入 Pull Request 阶段 ， 
这 个 代码 量 也 会 给 代码 审查 方 带 来 非常 重 的 负担 。 

开发 时 间 越 长 或 者 代码 量 越 大 ， 代 码 审查 时 的 成 本 就 越 高 。 过 长 的 
开发 时 间 让 审查 者 难以 了 解 开发 该 功能 时 的 背景 ， 过 大 的 代码 量 会 让 审 
查 者 难以 阅读 到 代码 的 每 个 细节 。 这 样 一 来 BUG 更 容易 出 现 ， 久 而 久 
之 整个 团队 的 代码 审查 都 会 漏洞 频 出 。 

在 这 种 团队 状态 及 环境 下 ， 要 把 经 过 漫长 时 间 编 写 出 来 的 代码 突然 
部 署 到 正式 环境 中 ， 将 会 是 一 个 让 人 旦 手 旦 脚 的 高 风险 工作 。 其 结果 便 
是 导致 整个 开发 速度 减缓 。 

与 开发 了 2 周 的 分 支 相 比 ， 只 开发 了 1 周 的 分 支 的 代码 量 更 少 ， 审 
查 者 在 理解 代码 时 的 成 本 也 更 小 ， 相 对 而 言 能 更 快 合 人 master 分 支 。 以 
此 类 推 , 花 3 天 时 间 开 发 出 的 代码 会 怎样 ? 花 1 天 时 间 开 发 出 的 代码 又 
会 怎样 ? 相信 各 位 可 以 想象 得 出 。 

在 刚刚 采用 这 一 开发 流程 ， 对 整个 流程 还 不 是 很 习惯 时 ， 建 议 各 位 
将 目标 功能 细 分 ， 尽 量 缩小 Pull Request 的 体积 ， 保 证 每 几 小 时 至 几 天 
向 master 分 支 发 送 一 次 Pull Request， 通 过 多 次 合并 来 实现 一 个 功能 。 
这 样 一 来 不 但 能 有 一 个 很 好 的 开发 节奏 ， 软 件 的 成 长 过 程 也 能 够 更 加 安 
全 可 靠 。 

所 以 各 位 在 创建 新 的 分 支 之 前 ,不 妨 先 对 目标 功能 或 内 容 进 行 讨 
论 ， 看 看 是 否 能 分 割 成 几 个 更 小 的 Pull Requesto 





b 



















































































E 



























































e 准备 可 供 试 运行 的 环境 

不 管 我 们 写 了 多 少 测试 代码 ， 只 要 该 分 支 中 包含 了 对 软件 关键 部 分 
的 修改 ， 在 将 其 部 署 到 正式 环境 时 都 需要 极 大 的 勇气 ， 而 且 这 时 还 伴随 
着 很 高 的 风险 。 
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于 是 ， 我 们 不 妨 创建 一 个 与 正式 环境 高 度 相 似 的 预演 ( Staging ) 环 
境 ， 在 这 个 预演 环境 中 部 署 关 键 修 改 ， 借 以 确认 代码 的 实际 运行 状况 。 
当然 ， 向 预演 环境 的 部 署 也 需要 实现 自动 化 。 

如 果 分 支 中 包含 “对 数据 库 进 行 了 大 幅 修改 ” “实施 了 大 规模 重 
构 ”“ 对 充值 处 理 部 分 进行 了 大 幅 修改 ”这 类 对 系统 有 重大 影响 的 关键 
性 修改 ， 为 安全 起 见 最 好 先 将 其 部 署 到 预演 环境 中 进行 试 运行 。 但 要 注 
意 ,不 要 把 所 有 修改 都 拿 到 预演 环境 中 进行 试 运行 ， 免 得 画蛇添足 。 

近来 的 Web 应 用 程序 往往 会 先 对 部 分 用 户 (通常 是 1%) 进行 部 
署 ， 通过 Twitter 等 SNS 监控 是 否 出 现 了 重大 影响 。 

如 果 出 于 不 安 总 想 把 部 署 向 后 搁置 ， 不 如 准备 一 个 环境 来 消除 不 
安 ， 让 代码 可 以 迅速 部 署 到 正式 环境 中 。 















































@ 不 要 让 Pull Request 中 有 太 多 反馈 


笔者 在 接 到 Pull Request 时 遇 到 过 下 面 这 种 情况 : 代码 存在 多 处 问 
题 ， 进 行 多 次 指正 和 修改 后 仍然 无 法 达到 与 master 分 支 合 并 的 水 准 。 出 
现 这 种 情况 大 概 有 两 个 原因 。 

一 是 交流 不 足 。 如 果 创 建 Pull Request 的 理由 没有 获得 认同 ， 那 就 
不 要 通过 Pull Request 进行 讨论 ， 而 是 应 该 选择 其 他 手段 进行 交流 。 最 
好 的 解决 途径 是 直接 面谈 。 

另 一 个 原因 是 技术 或 能 力 不 足 。 如 果 代 码 经 常 被 指出 问题 ， 那 么 不 
是 编程 能 力 方 面 有 问题 ， 就 是 团队 编写 代码 时 没有 一 个 明确 的 规则 。 为 
避免 在 无 用 的 讨论 上 浪费 时 间 ， 团 队 应 该 制定 一 个 最 低 限 度 的 编程 规 
则 ， 并 且 告 知 每 一 名 团队 成 员 。 如 果 在 开发 过 程 中 还 需要 其 他 规则 ， 可 
以 将 这 些 规 则 整合 到 Wiki 中 ， 便 于 阅览 及 修改 。 

如 果 在 类 的 设计 、 方 法 的 实现 、 变 量 的 命名 等 方面 频繁 出 现 问题 ， 不 
妨 实施 一 些 能 提高 开发 者 编码 技术 的 措施 ， 效 果 要 远 好 于 一 遍 遍 反复 指正 。 































































































结对 编程 
组 织 学 习 小 组 共享 知识 
。 共享 可 供 参 考 的 资料 
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不 知 各 位 的 团队 中 是 否 实施 了 这 些 措施 。 在 这 些 措 施 之 中 ， 结 对 编 
程 收 效 最 佳 。 

GitHub Flow 是 以 部 署 为 中 心 的 开发 流程 ， 所 以 要 求 团队 中 每 一 名 
开发 者 都 能 编写 出 高 品质 的 代码 ， 以 便 顺 利通 过 审查 ， 迅 速 完成 从 合并 
到 部 署 的 过 程 。 因 此 需要 锻炼 开发 者 ， 保 证 每 一 名 团队 成 员 都 能 达到 这 
= 



































e 不 要 积攒 Pul Request 


在 以 部 署 为 中 心 的 开发 流程 中 ， 如 果 总 有 大 量 Pull Request 处 于 等 
待 审查 或 等 待 修正 的 状态 ， 会 导致 长 期 无 法 部 署 ， 引 发 严重 问题 。 

如 果 每 一 名 开发 者 都 在 忙于 实现 各 自 的 新 功能 ， 把 所 有 精力 都 放 在 
编写 代码 和 创建 Pull Request 上 ， 势 必 会 忽视 审查 与 反馈 工作 。 时 间 一 
长 ， 无 法 部 署 的 Pull Request 就 会 堆积 如 山 。 

为 防止 这 一 情况 发 生 ， 建 议 团队 制定 一 个 新 的 规则 想 创建 Pull 
Request 的 人 要 先 去 对 其 他 人 的 Pull Request 进行 审查 及 反馈 ， 并 在 可 以 
部 署 时 及 时 部 署 。 

这 样 一 来 ， 自 己 想 创建 Pull Request 时 必须 先 处 理 其 他 人 的 Pull 
Request， 就 可 以 有 效 避 免 Pull Request 堆积 的 情况 发 生 。 






























































9.7 GitHub Flow 的 小 结 





笔者 根据 自身 经 验 ， 提 出 了 一 些 开发 现场 容易 出 现 的 问题 。 各 位 在 
开发 的 过 程 中 必然 还 会 遇 到 其 他 恼人 的 问题 。 对 于 这 些 问 题 ， 请 遵循 以 
下 这 两 点 去 寻找 解决 方案 。 

















。 开 发 流程 以 部 署 为 中 心 
。 高 速 源 于 简单 
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只 要 不 偏离 这 两 点 ， 各 位 一 定 能 找到 适合 自己 开发 现场 的 解决 
方案 。 








9.8 Git Flow 





以 发 布 为 中 心 的 开发 模式 


荷兰 程序 员 Vincent Driessen 曾 发 表 了 一 篇 博客 ”， 让 一 个 分 支 策 略 
广为人知 ， 那 就 是 A successful Git branching model。 这 里 我 们 将 向 各 位 
介绍 一 个 以 它 为 基础 ， 组 合 了 GitHub 的 开发 流程 。 

在 这 个 开发 流程 中 ， 每 个 分 支 都 显示 出 代码 的 当前 状态 。 流 程 中 
设置 了 负责 管理 软件 发 布 Release 的 发 布 管理 员 ， 适 用 于 以 发 布 为 中 心 
的 软件 开发 。 

通过 整体 的 流程 图 (图 9.15 )， 我 们 不 难看 出 该 流程 分 支 间 的 代码 
流向 十 分 复杂 。 关 于 每 部 分 的 详细 内 容 我 们 将 在 稍 后 进行 讲解 。 
































@ 便于 理解 的 标准 流程 


从 软件 开发 者 的 角度 观察 这 一 开发 流程 时 会 发 现 ， 该 流程 用 分 支 名 
表示 标准 软件 开发 中 开发 状态 的 迁移 。 

















@ 从 开发 版 的 分 支 ( develop ) 创建 工作 分 支 ( feature branches )， 进 
行 功能 的 实现 或 修正 

@ 工作 分 支 (feature branches) 的 修改 结束 后 ， 与 开发 版 的 分 支 
( develop ) 进行 合并 

O 重复 上 述 @ 和 @， 不 断 实 现 功 能 直至 可 以 发 布 

O 创建 用 于 发 布 的 分 文 ( release branches )， 处 理发 布 的 各 项 工作 

O 发 布 工作 完成 后 与 master 分 支 合并 ， 打 上 版 本 标签 (Tag) 进行 发 布 

O 如 果 发 布 的 软件 出 现 BUG， 以 打 了 标签 的 版 本 为 基础 进行 修正 
( hotfixes ) 




















(D http://nvie.com/posts/a-successful-git-branching-model/ 
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9.15 A successful Git branching model 





feature release 
branches develop branches hotfixes master 


Time 







From this point on, 
"next release" 


means the release 
after 10 











X Vincent Driessen “A successful Git branching model-nvie.com" ( http://nvie.com/posts/ 
a-successful-git-branching-model/ ) 


整个 流程 看 上 去 应 该 比较 好 理解 。 这 一 流程 最 大 的 亮点 在 于 考虑 了 
紧急 的 BUG 应 对 措施 。 
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@ 有 时 显得 过 于 复杂 


这 个 开发 流程 的 问题 在 于 需要 记忆 的 分 支 状态 很 多 ， 在 实施 之 前 必 
须 对 整个 开发 流程 进行 系统 地 学 习 。 虽 然 团队 成 员 可 以 通过 我 们 即将 讲 
到 的 git-flow ”等 工具 得 到 辅助 ， 但 很 多 情况 下 ， 流 程 整体 对 于 我 们 的 实 
际 开发 现场 来 说 仍然 显得 过 于 复杂 。 

在 这 个 流程 中 ， 程 序 员 必 须 理 解 自 己 正 在 进行 的 修改 会 对 哪些 分 支 
产生 影响 。 一 个 分 支 的 工作 结束 后 ， 有 时 需要 与 多 个 目标 分 支 合并 。 这 
些 是 该 流程 中 最 为 复杂 的 部 分 ， 需 要 团队 谨慎 处 理 。 同 时 由 于 其 复杂 程 
度 高 ， 容 易 出 现 操 作 失误 等 人 为 错误 。 所 以 团队 需要 使 用 git-flow ET 
具 进 行 辅助 ， 时 刻 保证 开发 不 偏离 流程 。 

考虑 到 上 述 种 种 因素 ， 各 位 的 团队 在 采用 这 一 开发 流程 之 前 必须 进 
行 系统 学 习 ， 充 分 掌握 其 优势 与 劣势 。 下 面 ， 我 们 先 为 该 流程 的 辅助 工 
具 构 筑 环境 ， 再 通过 Git GitHub 的 操作 向 各 位 进行 详细 讲解 。 
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@ 安装 git-flow 


现在 我 们 要 安装 git-flow， 各 位 请 根据 自己 当前 的 环境 进行 安装 。 
git-flow 是 一 款 辅助 Git Flow 的 工具 ， 虽 然 不 安装 它 也 可 以 实施 该 开发 
流程 ， 但 那样 一 来 所 有 工作 都 必须 手动 完成 。 为 防止 出 现 人 为 失误 ， 这 
里 还 是 建议 各 位 安装 这 个 工具 。 








如 果 已 经 安装 了 Homebrew， 可 以 用 下 面 的 命令 轻松 完成 git-flow 














$ brew install git-flow 





(D  https;//github.com/nvie/gitflow 
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如 果 安 装 了 MacPorts， 则 使 用 下 面 的 命令 。 


$ sudo port install git-flow 


@…… Linux 下 的 安装 
Ubuntu 和 Debian GNU/Linux 等 已 经 为 用 户 准备 好 了 相应 软件 包 ， 
可 以 用 下 面 的 命令 直接 安装 。 


$ sudo apt-get install git-flow 


























如 果 沿 未 导入 包 管 理工 具 ， 可 以 用 下 面 的 方式 安装 。 


$ wget --no-check-certificate -q -0 - https://github.com/nvie/gitflow/r 
aw/develop/contrib/gitflow-installer.sh | sudo bash 实际 为 1 行 




















e— 确认 运行 状况 
如 果 能 像 下 面 例子 中 一 样 顺利 运行 git -£1ow 命 令 ， 就 证 明 git- 
flow 已 经 成 功 安 装 了 。 


$ git flow 
usage: git flow «subcommand» 





Available subcommands are: 
init Initialize a new git repo with support for the branching model. 
feature Manage your feature branches. 
release Manage your release branches. 
hotfix Manage your hotfix branches. 
support Manage your support branches. 
version Shows version information. 


e 仓库 的 初始 设置 
为 方便 讲解 这 个 流程 ， 我 们 假设 自己 正在 开发 博客 软件 。 











@…… 创建 仓库 


首先 要 在 GitHub 上 新 建 一 个 Git 仓库。 我 们 创建 了 一 个 附带 
README.md 文件 的 名 为 blog 的 仓库 。 紧 接着 我 们 来 clone 这 个 仓库 。 
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本 次 示例 中 我 们 的 账户 名 为 hirocaster， 仓 库 名 为 blog。 


$ git clone git@github.com:hirocaster/blog.git 
Cloning into 'blog'... 

remote: Counting objects: 3, done. 

remote: Total 3 (delta 0), reused 0 (delta 0) 
Receiving objects: 100% (3/3), done. 


Checking connectivity... done. 


@…… 进行 git flow 的 初始 设置 

下 面 我 们 为 git flow 进行 初始 设置 。 由 于 我 们 不 打算 更 改 默认 值 ， 
所 以 在 命令 后 附 上 - ad 参数。 执行 以 下 命令 后 ,仓库 中 会 自动 生成 开发 
流程 所 需 的 分 支 。 各 位 在 执行 git clone 后 请 务必 记得 执行 一 次 这 个 

















$ cd blog 
$ git flow init -d 
Using default branch names. 


Which branch should be used for bringing forth production releases? 
- master 
Branch name for production releases: [master] 


Branch name for "next release" development: [develop] 


How to name your supporting branch prefixes? 
Feature branches? [feature/] 

Release branches? [release/] 

Hotfix branches? [hotfix/] 

Support branches? [support/] 


Version tag prefix? [] 


查看 已 创建 的 分 文 。 


$ git branch -a 











* develop 
master 
remotes/origin/HEAD -» origin/master 


remotes/origin/master 


可 以 看 到 develop 分 文 已 经 创建 完毕 ， 现 在 我 们 已 经 切换 到 这 一 
分 支 。 
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@…… 在 远程 仓库 中 也 创建 develop 分 支 


日 前 我 们 在 本 地 环境 中 拥有 master 和 develop 两 个 分 支 ， 但 是 
GitHub 端的 远程 仓库 ”中 仍然 只 有 master 分 支 。 所 以 我 们 进行 push 操 
作 ， 在 GitHub 端的 远程 仓库 中 也 创建 一 个 develop 分 支 。 


$ git push -u origin develop 
Total 0 (delta 0), reused 0 (delta 0) 
To git@github.com:hirocaster/blog.git 

















* [new branch] develop -> develop 


Branch develop set up to track remote branch develop from origin. 


$ git branch -a 

* develop ”本 地 的 Gevelop 分 支 
master ”本 地 的 master 分 支 
remotes/origin/HEAD -> origin/master 
remotes/origin/develop GitHub 端 的 develop 分 支 


remotes/origin/master ”GitHub 端 的 master 分 支 


现在 GitHub 端的 仓库 中 也 有 了 develop 分 支 。 


今后 团队 会 以 GitHub 端的 develop 分 支 作为 开发 中 的 最 新 代码 ， 包 
括 我 们 在 内 的 所 有 团队 成 员 都 要 以 这 个 分 支 为 基础 进行 开发 。 

开发 的 基本 操作 流程 很 简单 。 我 们 先 在 本 地 仓库 中 对 代码 进行 修 
改 ， 然 后 push 到 GitHub 端 更 新 远程 仓库 ， 其 他 开发 者 再 从 GitHub rij 

远程 仓库 获取 最 新 代码 到 本 地 进行 开发 。 

开发 者 要 时 刻 注意 ， 对 分 支 进行 任何 操作 之 前 都 必须 先 执行 pull 获 
取 最 新 代码 ， 修 改 完毕 后 应 尽快 进行 push 操作 ， 保 证 GitHub 端 远程 仓 
库 内 的 代码 为 最 新 状态 。 



































9.10 ”模拟 体验 Git Flow 


接 下 来 ， 我 们 开始 实践 Git Flows 





(D GitHub 端的 远程 仓库 为 remotes/origin 
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@ master 分 支 与 develop 分 支 的 区 别 

下 面 我 们 先 给 各 位 讲 一 讲 master 分 支 与 develop 分 支 的 相关 内 容 。 
在 Git Flow 中 这 两 个 分 支 至 关 重 要 ， 它 们 会 贯彻 整个 流程 始终 ， 绝 对 不 
会 被 删除 。 




















@…… master 分 支 





master 分 文 时 常 保持 着 软件 可 以 正常 运行 的 状态 。 由 于 要 维持 这 一 
状态 ， 所 以 不 允许 开发 者 直接 对 master 分 支 的 代码 进行 修改 和 提交 。 
其 他 分 支 的 开发 工作 进展 到 可 以 发 布 的 程度 后 ， 将 会 与 master 分 文 
进行 合并 ,而且 这 一 合并 只 在 发 布 成 品 时 进行 。 发 布 时 会 附加 包含 版 本 
编号 的 Git 标签 ( Tag )。 这 部 分 的 详细 内 容 我 们 将 在 后 面 进行 讲解 。 















































@……. develop 分 支 


develop 分 支 是 开发 过 程 中 的 代码 中 心 分 支 。 与 master 分 支 一 样 ， 
这 个 分 支 也 不 允许 开发 者 直接 进行 修改 和 提交 。 

程序 员 要 以 develop 分 支 为 起 点 新 建 feature 分 支 ， 在 feature 分 支 中 
进行 新 功能 的 开发 或 者 代码 的 修正 。 也 就 是 说 ，develop 分 支 维 持 着 开 
发 过 程 中 的 最 新 源 代码 ， 以 便 程序 员 创 建 feature 分 支 进行 自己 的 工作 。 
































@ 在 feature 中 进行 的 工作 


feature 分 支 以 develop 分 支 为 起 点 ， 是 开发 者 直接 更 改 代码 发 送 提 
交 的 分 支 。 开 发 以 下 述 流程 进行 。 








Q 从 develop 分 支 创 建 feature 分 支 

© 在 feature 分 支 中 实现 目标 功能 

© 通过 GitHub 向 develop 分 支 发 送 Pull Request 

O 接受 其 他 开发 者 审查 后 ， 将 Pull Request 合并 至 develop 分 文 





与 develop 分 支 合 并 后 ,已 经 完成 工作 的 feature 分 支 就 失去 了 作 
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适当 的 时 候 删 除 。 
为 方便 进行 具体 讲解 ， 现 在 假设 我 们 要 给 软件 实现 一 个 添加 用 户 的 








@…… 创建 分 支 


上 面 我 们 提 到 过 develop 分 支 是 feature 分 支 的 起 点 ， 所 以 我 们 要 从 
最 新 状态 的 develop 分 支 新 建 一 个 feature 分 支 ， 在 这 个 分 支 中 实现 添加 
用 户 的 功能 。 这 里 我 们 将 分 支 名 定 为 add-user。 

首先 要 将 develop 分 支 更 新 至 最 新 状态 。 我 们 从 GitHub 的 远程 仓库 

进行 pull 操作 。 这 一 操作 要 在 develop 分 支 下 进行 。 


$ git pull 

















Already up-to-date. 


由 于 我 们 本 地 的 develop 分 支 已 经 是 GitHub 端 远 程 分 支 的 最 新 状 
态 ， 所 以 执行 git pull 命令 后 没有 任何 变化 。 如 果 远 程 分 支 被 其 他 开发 
者 更 新 过 ， 那 么 我 们 的 本 地 develop 分 支 将 会 通过 这 一 操作 获取 到 最 新 
代码 。 
创建 feature 1 3c add-user， 用 来 实现 添加 用 户 的 功能 。 


$ git flow feature start add-user 


























Switched to a new branch 'feature/add-user' 


Summary of actions: 
- A new branch 'feature/add-user' was created, based on 'develop' 


- You are now on branch 'feature/add-user' 
Now, start committing on your feature. When done, use: 


git flow feature finish add-user 


我 们 已 经 创建 并 切换 到 了 feature/add-user 分 支 。 保 险 起 见 ， 让 我 们 
来 确认 一 下 。 


$ git branch 
develop 

* feature/add-user 
master 
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结果 显示 我 们 处 于 feature/add-user 分 支 下 。 现 在 的 状态 正如 图 9.16 
所 示 。 


图 9.16 Æ feature 分 支 后 的 状态 





feature/add-user develop 











e@…… 在 分 支 中 进行 作业 


接 下 来 在 刚刚 创建 的 feature/add-user 分 文中 实现 目标 功能 并 进行 提 
交 。 实 际 编写 代码 以 及 提交 的 过 程 在 此 就 不 再 赣 述 。 进 行 几 次 提交 后 ， 
就 会 呈现 图 9.17 的 状态 。 


图 9.17 ”提交 后 的 状态 














feature/add-user develop 


start © 
commit Q 


commit (C) 











图 灵 社 区 会 员 lxghost2 GF 尊重 版 权 









































216 | 第 9 章 使 用 GitHub 的 开发 流程 
e 发 送 Pull Request 


功 


能 实现 之 后 ， 需 要 通过 GitHub 发 送 Pull Request， 请 求 develop 


分 支 合 并 feature/add-user 分 支 的 内 容 。 请 注意 ， 这 里 不 能 与 本 地 的 Git 
仓库 进行 合并 ， 而 是 要 利用 GitHub 的 Pull Request 功能 接受 代码 审查 ， 
然后 再 合并 到 远程 仓库 的 分 支 中 。 这 样 可 以 让 其 他 开发 者 看 到 我 们 的 代 
码 ， 从 而 指出 其 中 的 问题 。 如 果 在 设计 上 有 不 同意 见 还 可 以 进行 讨论 ， 


以 便 写 
首 





























出 更 高 品质 的 代码 。 通 过 这 些 措 施 ， 可 以 有 效 提 高 代码 质量 。 
先 我 们 将 feature/add-user 分 支 push 到 GitHub 端 远程 仓库 。 











$ git push origin feature/add-user 


Counting objects: 6, done. 


Delta compression using up to 8 threads. 


Compressing objects: 100% (4/4), done. 

Writing objects: 100% (5/5), 452 bytes | 0 bytes/s, done. 
Total 5 (delta 1), reused 0 (delta 0) 

To gitGgithub.com:hirocaster/blog.git 


* [new branch] feature/add-user -» feature/add-user 


如 





果 是 与 其 他 开发 者 共同 开发 同一 个 feature 分 支 ， 那 么 远程 仓库 的 




















add-user 分 支 可 能 已 经 被 更 新 ， 要 记得 通过 pull 操作 获取 add-user 分 支 
的 最 新 代码 。 另 外 ， 在 我 们 开发 这 个 feature 分 支 的 过 程 中 ，develop 分 





文 可 能 


的 习惯 
现在 打开 GitHub 的 仓库 页 面 ， 切 换 到 feature/add-user 分 支 (图 


9.18 )。 
点 


认 








zu 























zu 














有 了 最 新 版 本 ， 所 以 要 养 成 在 push 之 前 先 获 取 最 新 develop 分 支 
。 确 保 上 述 两 点 之 后 再 进行 push。 


























击 切 换 分 支 菜单 左 侧 的 绿色 图 标 ， 进 入 查看 差别 的 页 面 。 先 要 
下 页 面 中 显示 的 是 否 为 develop 分 文 和 feature/add-user 分 支 。 














如 果 发 现 是 master 等 其 他 分 支 ， 需要 点 击 右 侧 的 Edit 按钮 进行 切换 
(图 9.19 )。 





认 页 面 中 显示 的 对 象 为 “develop...feature/add-user” 后 ， 点 击 


Click to create a pull request for this comparison。 随 后 会 出 现 录入 Pull 
Request 信息 的 页 面 ， 供 我 们 发 送 Pull Request。 
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E] hirocaster / blog GiUnwath - 1 k Star 0 |P Fork o 
Description Website 
Short description of this repository Website for this repository (optional) Save orcancel <> Code 
© Issues o 
2 commits 5 branches 1 release 1 contributor 


V branch: feature/add-us... ~ blog / 


This branch is 1 commit aj ind 4 commits behind master 
Add feature user-add 

[E] hrocaster authored 5 bons ago 

B README.md Initial commit 


B] user-add Add feature user-add 


显示 feature/add-user 4j xx 


blog 


T^ Pull Requests o 


EB Wiki 

"] Pull Request |*; Compare 
^ Pulse 

latest t 1343beb760 & 

atest commi e & lii Graphs 
5 months ago 

P Network 
5 months ago 

X Settings 

SSH clone URL 


gitégithub.com:hi | 篇 


You can clone with HTTPS, SSH, 
Subversion, and other methods. 





Clone in Desktop 





9.19 ”切换 分 支 的 按钮 





E] hirocaster / blog 


u 人 | DER 


Click to create a pull request for this comparison 


1 commit 1 file changed 


Mar 12,2013 


[Ed nirocaster Add feature user-add 
[E] Showing 1 changed flle with 0 additions and 0 deletions. 


ONEEEE  user-add 


0 comments 1 contributor 


1343beb 


Show Diff Stats 


View file @ 1343beb 











发 送 Pull Request 之 后 ， 便 是 图 9.20 所 示 的 状态 。 


e 通过 代码 审查 提高 代码 质量 


发 送 Pull Request 之 后 ， 通 过 下 列 步骤 利用 Pull Request 从 其 他 开 


者 那里 获取 反馈 ,不断 精炼 代码 。 








n 











@ 由 其 他 开发 者 进行 代码 审查 ， 在 Pull Request 中 提供 反馈 
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图 9.20 “ 发送 Pull Request 后 分 支 的 状态 





start © 
SO 


commit 


finish PR 





feature/add-user develop 


O 








O 修正 代码 以 反映 反馈 内 容 (在 本 地 feature/add-user 分 支 中 ) 
目 将 feature/add-user 分 支 push 到 远程 仓库 ( 自动 添加 至 之 前 的 Pull 


Request ) 
@ 重复 前 三 步 





© 确认 Pull Request 没有 问题 后 ， 由 其 他 开发 者 将 其 合并 至 develop 


Ax 





下 面 是 几 个 反馈 的 要 点 。 











。 没有 测试 or 测试 未 通过 
。 违反 编码 规则 











e 代码 品质 过 低 ( 命名 不 明确 ， 方 法 元 长 等 ) 














。 还 有 重 构 的 余地 
。 有 重复 部 分 





能 否 按照 以 上 要 点 在 代码 审查 中 追求 高 


I 











编写 代码 的 能 力 。 经 常 在 审查 时 数 衍 了 事 随 意 合并 ， 


HH AS s 


过 


果 发 现代 码 品质 仍 有 提高 空间 ， 建 议 先进 行 反馈 ， 不 要 急 着 合并 。 


直接 影响 到 一 个 团队 
最 后 成 品 软件 的 质 
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量 不 可 能 过 硬 。Pull Request 的 反馈 并 不 只 属于 发 送 Pull Request 的 人 ， 
它 可 以 由 整个 团队 共享 ， 促进 相 互 学习 。 男 外 ， 不 特别 限定 Pull Request 
的 代码 审查 者 ， 让 各 个 成 员 都 主动 进行 审查 ， 能 够 帮助 团队 维持 高 品质 
高 效率 的 开发 。 






































e 更 新 本 地 的 develop 分 支 


我 们 发 送 的 Pull Request 在 GitHub wm develop 合并 后 ， 为 让 其 反 
映 到 本 地 的 develop 分 支 中 ， 我 们 需要 进行 以 下 操作 。 








e 切换 至 develop 分 文 
e 执行 git pull ( fetch & merge ) 


这 样 一 来 ， 本 地 develop 分 支 就 从 GitHub 端 仓库 获取 了 最 新 状态 。 


$ git checkout develop 
Switched to branch 'develop' 


S git pull 
remote: Counting objects: 1, done. 
remote: Total 1 (delta 0), reused 0 (delta 0) 
Unpacking objects: 100% (1/1), done. 
From github.com:hirocaster/blog 
adi39da..9299f28 develop -> origin/develop 
Updating ad139da..9299f28 
Fast-forward 
add-user-1 | 0 
add-user-2 | 0 
2 files changed, 0 insertions(+), 0 deletions (-) 
create mode 100644 add-user-1 
create mode 100644 add-user-2 


每 当 需 要 从 develop 分 支 创建 feature 等 分 支 时 ， 记 得 一 定 要 先 执行 
述 操作 ， 保 证 develop 分 支 处 于 最 新 状态 
在 实际 开发 中 ， 我 们 会 不 断 重复 之 前 这 一 系列 流程 不 断 为 develop 
分 支 添加 功能 。 当 功能 积 失 到 足以 发 布 时 ， 就 会 用 到 release 分 支 。 
下 面 我 们 假设 软件 已 经 可 以 发 布 ， 将 要 使 用 release 分 文 。 
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@ 在 release 分 支 


现在 假设 我 们 已 经 通 





会 已 
HE 
eu 
HE 











中 进行 的 工作 








过 feature 分 支 为 develop 分 支 添加 了 数 个 功 
， 软 件 进入 了 发 布 阶段 。 在 这 一 阶段 ， 我 们 要 实现 所 有 要 发 布 的 功 
， 发 送 Pull Request 并 且 与 develop 分 支 合并 。 


接 下 来 给 软件 分 配 一 个 版 本 号 进行 发 布 。 今 后 对 这 个 版 本 的 软件 只 


做 BUG 修复 ， 不 再 进行 其 他 支持 。 如 明 
那么 绝对 不 可 以 进入 我 们 即将 讲解 的 工作 阶段 。 我 们 接 下 来 要 讨 




















作 ， 都 需要 发 布 管理 员 负 起 责任 认真 执行 。 


专栏 : 设置 默认 


如 果 每 次 发 送 





分 支 
关 Pull Request 时 都 要 从 master 4 x 3j 








到 develop 2 x , 

















GitHub 的 仓库 设 














的 默认 分 支 ， 省 去 手动 修改 的 麻烦 。 
É GitHub 仓库 的 Settings 页 面 可 以 找到 图 a 所 示 的 Default 








发 布 所 需 的 工作 尚未 全 部 完成 ， 





F 解 的 操 


F 动 切换 
显然 容易 出 现 操作 失误 。 对 此 ， 我 们 可 以 更 改 


， 指 定 develop 分 支 为 发 送 Pull Request 时 





















































Branch 项 





























仓库 时 就 会 默认 

















认 指 向 develop 分 支 。 
图 a 默认 分 支 的 设置 页 面 


目 。 只 要 将 这 里 改 为 develop ， 我 们 再 通过 浏览 器 访问 
EE 示 develop 分 支 ， 发 送 Pull Request 时 也 会 默 





| Options 
Collaborators 
Webhooks & Services 


Deploy Keys 





Settings 





Features 


回 Wikis 
GitHub Wikis are the simplest way to let others contribute content. Any GitHub user can create and edit 
pages to use for documentation, examples, support or anything you wish. 


口 Restrict edits to Collaborators only 
Public Wikis will still be readable by everyone. 


Issues 
GitHub Issues adds lightweight issue tracking tightly integrated with your repository. Add issues to 
milestones, label issues, and close & reference issues from commit messages. 


GitHub Pages 
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e- 创建 分 支 
我 们 从 最 新 的 develop 分 支 着 手 ， 开 始 1.0.0 版 本 的 release 工作 。 


切换 至 develop 分 支 
$ git checkout develop 
Switched to branch 'develop' 


获取 最 新 develop 分 支 的 代码 
$ git pull 
Already up-to-date. 


开始 release 分 支 
$ git ilow release scare "1.0.0! 


Switched to a new branch 'release/1.0.0' 


Summary of actions: 
- A new branch 'release/1.0.0' was created, based on 'develop' 


- You are now on branch 'release/1.0.0' 


Follow-up actions: 

- Bump the version number now! 

- Start committing last-minute fixes in preparing your release 
- When done, run: 


git flow release finish '1.0.0' 








release/1.0.0 分 支 已 经 成 功 创建 ， 它 就 是 这 次 的 release 273. (图 9.21 )。 


图 9.21 release 分 支 创 建 后 的 状态 








feature/add-user develop release 
1 1 
1 1 
T 1 
Start 1 1 
1 1 
1 1 
; 1 1 
commit | I 
1 1 
1 1 
commit | 
1 1 
1 1 
finish PR 1 1 
1 
1 


1 
1 1 (Qoo start 
1 
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@…… 分支 内 的 工作 


在 这 个 分 支 中 ,我 们 只 处 理 与 发 布 前 准备 相关 的 提交 。 比 如 版 本 编号 
变更 等 元 数据 的 添加 工作 。 如 果 软 件 部 署 到 预演 环境 后 经 测试 发 现 BUG， 
相关 的 修正 也 要 提交 给 这 个 分 支 。 但 要 记 住 ， 该 分 文中 绝对 不 可 以 包含 需 
求 变更 或 功能 变更 等 重大 修正 。 这 一 阶段 的 提交 数 应 该 限制 到 最 低 。 





e 进行 发 布 与 合并 
发 布 前 的 修正 全 部 处 理 完 后 ， 我 们 结束 这 一 分 支 。 


$ git flow release finish OO 


当前 状态 如 图 9.22 所 示 。 





9.22 release finish 之 后 





feature/add-user develop release 
1 1 
1 1 
1 
Start i 
1 
1 
commit | 
1 
1 
commit i 
1 
1 
finish PR | 
1 
1 


1.0.0 start 


1.0.0 finish 














release 分 支 将 合并 至 master 分 支 。 分 支 在 合并 时 会 询问 提交 信息 ， 
如 果 没 有 需要 特别 声明 的 事项 ， 可 以 直接 保持 默认 状态 。 
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Merge branch 'release/1.0.0' 


Please enter a commit message to explain why this merge is necessary, 


especially if it merges an updated upstream into a topic branch. 


Lines starting with '#' will be ignored, and an empty message aborts 


the commit. 


接 下 来 ， 合 并 后 的 master 分 支 会 加 入 一 个 与 版 本 号 相同 编号 的 标签 。 


Release 1.0.0 





Write a tag message 
Lines starting with '#' will be ignored. 








在 这 里 我 们 需要 输入 这 一 版 本 的 相关 提交 信息 。 当 前 状态 如 图 9.23 
所 示 。 


图 9.23 ” master 分支 添 加 标签 后 的 状态 





feature/add-user develop release master 
1 1 1 

1 1 
1 
start i 
1 
1 
commit i 
1 
1 
. 1 
commit 1 
1 
1 
-" 1 
finish PR 1 
1 
1 


1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1.0.0 start i 
1 
1 
1 
1 
1 
1 


O tag 1.0.0 
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随后 ， 将 release 分 支 的 状态 合并 至 develop 分 支 。 如 果 出 现 合并 提 
交 ， 则 系统 会 询问 提交 信息 。 


Merge branch 'release/1.0.0' into develop 








# Please enter a commit message to explain why this merge is necessary, 
# especially if it merges an updated upstream into a topic branch. 

# 

# Lines starting with '#' will be ignored, and an empty message aborts 
# the commit. 








T 


全 部 工作 结束 后 ， 会 显示 如 下 字样 。 


$ git flow release finish 11.0.0“ 








Switched to branch 'master' 
Your branch is ahead of 'origin/master' by 3 commits. 
(use "git push" to publish your local commits) 
Merge made by the 'recursive' strategy. 
release | 0 
1 file changed, 0 insertions(+), 0 deletions (-) 
create mode 100644 release 
Switched to branch 'develop' 
Your branch is up-to-date with 'origin/develop'. 
Merge made by the 'recursive' strategy. 
release | 0 
1 file changed, 0 insertions(+), 0 deletions(-) 
create mode 100644 release 
Deleted branch release/1.0.0 (was 9a754a2). 


Summary of actions: 

- Latest objects have been fetched from 'origin' 
- Release branch has been merged into 'master' 

- The release was tagged '1.0.0' 


- Release branch has been back-merged into 'develop' 





- Release branch 'release/1.0.0' has been deleted 


当前 的 状态 如 图 9.24 Brz o 





e 查看 版 本 标签 
通过 前 面 一 系列 操作 ， 我 们 创建 了 与 发 布 版 本 号 相同 的 Git 标签 。 


$ git tag 
L000 





























今后 如 果 遇 到 什么 问题 ， 只 要 指定 这 个 标签 ， 就 可 以 将 软件 回溯 到 
相应 版 本 。 
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图 9.24 release 分 支 合 并 到 develop 分 支 后 的 状态 





feature/add-user develop release master 


Start 


1 

1 

1 

r 1 
commit 1 
Q | 
1 

1 

1 

1 

1 

1 

1 

1 


commit 


1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
1 
finish PR l 
1 
1 


OO 1.0.0 start 


o7 176. 100 


I 
I 
I 
I 
I 
1 
1 
1 
I 
I 
I 
I 
I 
I 
1 
I 
1 
I 
1 
1 
1 
1 
1 
I 
I 
I 
I 
I 
1.0.0finish | 
LI 











e 更 新 到 远程 仓库 


至 此 我 们 对 多 个 分 支 进 行 了 修改 ， 所 以 需要 利用 push 操作 将 修改 
更 新 到 GitHub 端的 远程 仓库 。 我 们 先 从 develop 分 支 开 始 。 


$ git push origin develop 





Counting objects: 5, done. 
Delta compression using up to 8 threads. 
Compressing objects: 100% (3/3), done. 
Writing objects: 100% (3/3), 360 bytes | 0 bytes/s, done. 
Total 3 (delta 2), reused 0 (delta 0) 
To git@github.com:hirocaster/blog.git 
9299f28..c8add0a develop -> develop 


然后 是 master 分 支 。 
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$ git checkout master 

Switched to branch 'master' 

Your branch is ahead of 'origin/master' by 5 commits. 
(use "git push" to publish your local commits) 


$ git push origin master 
Counting objects: 1, done. 


Writing objects: 100% (1/1), 227 bytes | 0 bytes/s, done. 


Total 1 (delta 0), reused 0 (delta 0) 
To gitegithub.com:hirocaster/blog.git 
adi39da..5651cfd master -» master 


再 push 标签 信息 。 


$ git push --tags 





Counting objects: 1, done. 


Writing objects: 100% (1/1), 163 bytes | 0 bytes/s, done. 


Total 1 (delta 0), reused 0 (delta 0) 
To gitGgithub.com:hirocaster/blog.git 
* [new tag] TOO =S Ls et? 


版 本 号 1.0.0 的 标签 信息 已 经 push 完毕 ， 现 在 只 要 发 布 master 分 





文 ， 整 个 发 布 工作 就 结束 了 。 


@ 在 hotfix 分 支 中 进行 的 工作 
hotfix 分 支 并 不 是 预期 中 计划 出 现 的 分 支 。 





施 ， 只 有 当前 发 布 的 版 本 中 出 现 BUG 或 漏洞 ， nS 





个 紧急 应 对 措 


其 严重 


H 





m o 


旦 度 要 求 








开发 方 必须 立刻 处 理 ， 无 法 等 到 下 一 个 版 本 发 布 时 ，hotfix 分 支 才 会 


被 创建 。 





因此 ，hotfix 分 支 都 是 以 发 布 版 本 的 标签 或 master 分 支 为 起 点 。 借 


BJ hotfix 分 文 ， 可 以 在 不 影响 develop 分 支 正 常 开发 的 情况 下 ， 


开发 者 处 理 成 品 的 修正 工作 。 
图 9.25 是 该 分 支 迁移 过 程 的 示意 图 。 








e- 创建 分 支 
遇 到 下 述 情 况 时 需要 创建 hotfix 分 支 进行 应 对 。 





e 最 新 的 1.0.0 版 中 发 现 了 BUG 或 漏洞 
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H ZEN 








Lu 
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* develop 分 支 正 在 开发 新 功能 ， 无 法 面向 用 户 进行 发 布 
。 漏洞 需要 及 早 处 理 ， 无 法 等 到 下 一 次 版 本 发 布 








图 9.25 hotfix 分支 的 迁移 





develop master 


(79 


tag 1.0.0 


commit 


O PR 1 PR 


i tag 1.0.1 
1 
1 


ZOLL 











假设 修复 BUG 后 的 版 本 升 至 1.0.1。 

We 则 需要 先 
进行 获取 操作 。 当 然 ， 如 果 该 标签 就 是 由 本 地 仓库 创建 ， 那 么 就 不 必 进 
行 该 操作 了 。 不 过 为 了 保险 起 见 ，3 i Es 
获取 到 本 地 ， 确 认 标签 的 版 本 编号 是 否 有 误 。 以 下 命令 可 以 在 任何 分 支 
中 执行 。 


$ git fetch origin 


















































remote: Counting objects: 1, done. 
remote: Total 1 (delta 0), reused 1 (delta 0) 
Unpacking objects: 100% (1/1), done. 
From github.com:hirocaster/blog 
* [new tag] 3b). 1) sm ds) 


现在 以 1.0.0 的 标签 信息 为 起 点 ， 创 建 名 为 1.0.1 的 hotfix 分 支 。 


$ git flow hotfix start e D TUTO 
Switched to a new branch 'hotfix/1.0.1' 





Summary of actions: 





(D 相当 于 本 示例 中 1.0.0 的 信息 
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- A new branch 'hotfix/1.0.1' was created, based on '1.0.0' 


- You are now on branch 'hotfix/1.0.1' 


Follow-up actions: 
- Bump the version number now! 
- Start committing your hot fixes 


- When done, run: 


git ilow hotfix finish "1.0.1! 


以 1.0.0 标签 为 起 点 成 功 创建 了 hotfix/1.0.1 分 支 。 我 们 在 这 个 分 支 
中 修复 软件 的 漏洞 并 进行 提交 

修复 等 工作 全 部 结束 后 ， 将 hotfix 分 支 push 到 GitHub 端 远程 仓库 ， 
并 向 master 2? 3:35 Pull Request, 


$ git push origin hotfix/1.0.1 








Counting objects: 4, done. 
Delta compression using up to 8 threads. 
Compressing objects: 100$ (2/2), done. 
Writing objects: 100% (2/2), 242 bytes | 0 bytes/s, done. 
Total 2 (delta 1), reused 0 (delta 0) 
To gitGgithub.com:hirocaster/blog.git 
* [new branch] hoctix/1.0.1 -> hotfix/1.0.1 


o- 创建 标签 和 进行 发 布 


假设 我 们 发 送 的 Pull Request 经 过 了 其 他 开发 者 的 审查 ， 并 且 已 经 
与 master 分 支 合 并 。 现 在 就 该 利用 GitHub 的 功能 创建 1.0.1 的 标签 了 

访问 GitHub 的 仓库 页 面 ， 从 菜单 中 选择 release， 打 开 该 仓库 的 发 
布 信息 (图 9.26 )。 页 面 中 显示 了 我 们 之 前 创建 的 1.0.0 标签 的 相关 信息 
(图 9.27 )。 我 们 可 以 在 这 个 页 面 查看 以 及 创建 标签 的 相关 信息 。 









































9.26 ”显示 发 布 信息 








L E] hirocaster / blog G)Unwath ~ 1 Sta 0  Ẹ Fork o 
i 点 击 release 
gitflow sample repository. — Edit 
<> Code 
8 commits 4 branches 1 release 1 contributor 
© Issues o 
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图 9.27 ”标签 1.0.0 的 信息 





Releases / Tags Draft a new release 


1.0.0 E 


33 minut 
Henuves ago © 5651cfd [i)zip E tar.gz 











接 下 来 我 们 要 为 本 次 hotfix 创建 1.0.1 标签 。 先 点 击 Draft a new 
release 按钮 ， 再 输入 标签 的 相关 信息 ( 图 9.28 )。 在 Tag version 中 输入 
1.0.1， 在 Target 中 指定 master 分 支 ， 此 时 的 master 分 支 已 经 合并 了 
hotfix 1.0.1 分 支 的 修改 。Release title 和 Describe this release 并 不 是 必 填 
项 目 ， 各 位 可 以 根据 自身 情况 简明 扼要 地 输入 所 需 信 息 。 最 后 点 击 
Publish release 便 可 完成 创建 标签 的 工作 (图 9.29 )。 











9.28 “创建 1.0.1 标签 





1.0.1 @ p Target: master ~ 


Excellent! This tag will be created from the target when you publish this release. 


Release title 


Write Preview Parsed with GitHub Flavored Markdown 


z : m 
Describe this release E 


Attach images by dragging & dropping or selecting them. 


Attach binaries for this release by dropping them here. 


口 This is a pre-release 
We'll point out that this release is identified as non-production ready. 





Publish release Save draft 
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9.29 1.0.1 创建 后 的 状态 


ETT 1.0.1: Merge pull request #2 from 
9: Aw hirocaster/hotfix/1.0.1 


-© aí907962 ga hirocaster released this 36 minutes ago 





Hotfix 1.0.1 


图 Source code (zip) E) Source code (tar.gz) 




















这 个 1.0.1 版 本 发 布 后， 之 前 发 布 的 成 品 也 就 完成 了 生命 周期 。 
现在 我 们 让 本 地 仓库 再 获取 一 次 标签 ， 确 认 1.0.1 标签 是 否 成 功 
创建 。 


$ git fetch origin 


























remote: Counting objects: 1, done. 

remote: Total 1 (delta 0), reused 0 (delta 0) 
Unpacking objects: 100% (1/1), done. 

From github.com:hirocaster/blog 


5651cfd..af97962 master -» origin/master 
* [new tag] Loa SS borea 

$ git tag 

abc (0) 

dLc (0). 1l 


@…… 从 hotfix 分 支 合 并 至 develop 分 支 


至 此 我 们 虽然 已 经 修正 了 已 发 布 代 码 的 问题 ， 但 是 开发 中 的 develop 
分 支 仍 存在 这 些 漏洞 和 BUG。 因 此 我 们 需要 将 1.0.1 版 的 修改 合并 至 
develop 分 支 。 具 体操 作 很 简单 ， 只 需 登 录 GitHub, M hotfix/1.0.1 分 支 
向 develop 分 支 发 送 Pull Request 即 可 。 经 过 其 他 开发 者 的 审查 后 ， 修 改 
内 容 便 会 被 合并 到 develop 分 支 。 

如 果 合 并 后 develop 分 支出 现 了 异常 ， 切 记 不 要 在 hotfix/1.0.1 47 3c 
中 进行 修正 。 此 时 应 该 先 完成 hotfix 分 支 与 develop 分 支 的 合并 工作 ， 
然后 在 develop 分 支 中 尽快 修复 相关 问题 。hotfix/1.0.1 只 是 针对 master 
分 支 进行 内 容 修改 ， 如 果 再 强行 将 develop 分 支 考虑 进去 ， 很 可 能 带 来 
意料 之 外 的 BUG。 另外 ， 如 果 成 品 软件 中 包含 了 本 次 hotfix 以 外 的 多 余 
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修改 ,将 来 这 个 版 本 再 需要 hotfix 时 ， 我 们 就 不 得 不 考虑 更 多 更 复杂 的 
问题 。 因 此 ， 一 定 要 保证 hotfix 分 支 只 对 master 分 支 的 内 容 进行 最 小 限 
度 的 修改 。 

hotfix 分 支 与 master 分 支 和 develop 分 支 合 并 之 后 即 完成 了 使 命 ， 
可 以 被 删除 。 

以 上 便 是 hotfix 分 支 的 使 用 方法 。 至 此 我 们 所 讲解 的 分 支 迁移 正如 
图 9.30 所 示 。 


图 9.30 hotfix 分支 被 合并 后 的 状态 














feature develop release hotfix master 


Start 


finish PR 


Start 





—.- tag 1.0.0 
I 


I 
I 
1 
I 
I 
1 
1 
1 
1 
Q tag 1.0.1 
1 
Li 
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9.11 Git Flow 的 小 结 








这 一 开发 流程 在 软件 开发 世界 中 存在 已 入， 并 没有 什么 太 新 颖 的 地 
方 。 但 也 正 因 如 此 ， 它 更 容易 为 软件 开发 者 所 理解 。 

但 是 ， 由 于 在 实际 开发 现场 需要 多 人 分 工 合作 ， 这 一 开发 流程 往往 
会 变 得 很 复杂 。 建 议 各 位 把 开发 流程 图 ”放大 并 张贴 在 墙壁 上 ， 这 样 能 
够 有 效 帮 助 团队 成 员 理 解 流程 内 容 。 









































专栏 : 版 本 号 的 分 配 规 则 
版 本 控制 策略 规定 了 软件 版 本 号 的 分 配 规则 ， 因 此 制定 该 策 
略 时 应 当 尽 量 简单 易 懂 。 
比如 在 用 x.y.z 格式 进行 版 本 管理 时 的 规则 如 下 所 示 。 




























































































e x 在 重大 功能 变更 或 新 版 本 不 向 下 兼容 时 加 1， 此 时 y 与 z 
的 数字 归 0 
e y 在 添加 新 功能 或 者 删除 已 有 功能 时 加 1， 此 时 z 的 数字 归 0 
ez 只 在 进行 内 部 修改 后 加 1 


















































下 面 举 个 具体 例子 














e 1.0.0: 最 初 发 布 的 版 本 

e 1.0.1: 修正 了 轻微 BUG 

e 1.0.2: 修复 漏洞 

e 1.1.0: 添加 新 功能 

€ 2.0.0: 更 新 整体 UI 并 添加 新 功能 























这 便 是 版 本 号 的 大 致 分 配 规 则 。 
ARKAT Git Flow， 那 么 成 员 在 交流 的 时 候 会 经 常用 
RE 
























































(D  http;//nvie.com/files/Git-branching-model.pdf 
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本 章 中 ,我们 将 对 企业 等 工作 场所 引入 GitHub 时 的 相关 问题 进行 
探讨 。 程 序 员 应 该 将 资源 集中 于 编写 优秀 的 软件 上 ，GitHub 则 是 辅助 这 
一 过 程 的 工具 。 因 此 ， 当 今 的 软件 开发 企业 理应 积极 引入 GitHub。 本 章 
将 为 各 位 讲解 一 些 有 用 的 信息 ， 帮 助 各 位 在 企业 引入 GitHub。 


























10.1 将 世界 标准 的 开发 环境 引入 企业 现场 


笔者 认为 ，GitHub 已 经 称 得 上 一 种 世界 标准 的 开发 环境 。 至 少 在 开 
源 世 界 ， 几 乎 所 有 的 开源 项 目 都 在 GitHub 上 公开 过 源 代码 。 

另外 ,已 经 有 相当 多 的 企业 开始 使 用 OSS。 相 信 在 各 位 读者 之 中 ， 
相当 一 部 分 人 都 与 开源 世界 有 着 不 可 分 割 的 关联 。 





























@ 企业 引入 GitHub 的 好 处 


打 个 比方 ， 很 多 程序 员 在 业余 时 间 经 常 使 用 GitHub, WRH 
GitHub 引入 公司 ， 这 些 人 就 可 以 按照 自己 习惯 的 方式 进行 开发 ， 不 会 产 
生 多 余 的 压力 。 同 样 ， 让 新 入 行 的 程序 员 在 企业 中 使 用 GitHub， 能 使 他 
们 很 快 接触 到 开源 开发 世界 ， 促 使 他 们 对 GitHub 上 的 众多 软件 项 目 产 
生 兴 趣 。 

软件 行业 人 才 流 动 性 很 强 ， 一 般 情况 下 ， 程 序 员 半途 加 入 项 目 需 要 
先 熟悉 企业 内 部 软件 、 项 目 以 及 代码 的 相关 信息 ， 从 加 入 到 发 挥 作用 往 
往 需要 2 一 4 周 时 间 。 

然而 ， 由 于 相当 多 程序 员 都 在 使 用 GitHub ， 所 以 上 述 情况 如 果 放 在 
应 用 了 GitHub 的 企业 ， 很 可 能 新 员工 进 公 司 第 一 天 就 能 开始 编写 代码 
并 发 送 Pull Request 了 。 要 知道 ，GitHub 在 全 世界 已 经 相当 普及 。 

另外 ，GitHub 还 能 省 去 维护 内 部 仓库 服务 器 的 成 本 ， 让 程序 员 们 能 
全 神 贯 注 地 开发 软件 。 
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@ 使 用 Organization 


企业 导入 GitHub 时 建议 使 用 Organization 账户 ”。 利 用 这 一 功能 ,5 
以 让 开发 者 们 使 用 同一 控制 面板 ， 还 能 够 创建 团队 并 统一 管理 权限 。 另 
外 这 一 账户 还 为 企业 提供 了 用 户 管理 和 支付 等 便捷 功能 。 

费用 与 个 人 账户 不 同 。 具 体 情 况 请 参考 GitHub 的 Organization 


Plans", 












































0 确认 Github 的 安全 性 


1 于 源 代码 相当 于 企业 的 财产 ， 在 企业 中 导入 GitHub 时 势必 会 对 
言 息 安全 体制 有 所 顾虑 。 其 实 GitHub 公司 已 经 在 网 络 上 发 布 了 安全 保 
障 的 相关 信息 。 

] 户 的 数据 不 仅 被 严密 保管 在 GitHub 公司 的 数据 中 心 ， 该 公司 还 给 客 
服 人 员 制 定 了 严格 的 操作 规范 及 相关 权限 。 详 细 内 容 请 查阅 官方 网 站 “。 


















































@ 注意 维护 时 间 


GitHub 在 一 年 内 会 有 几 次 短 时 间 的 系统 维护 ， 国 内 的 企业 在 这 一 点 
需要 加 以 注意 。 

GitHub 的 维护 时 间 选 在 美国 的 深夜 ， 因 为 时 差 的 关系 国内 会 是 白 
天 。 也 就 是 说 ， 那 几 天 我 们 可 能 会 在 工作 时 间 中 无 法 访问 GitHub。 

GitHub 方 会 在 维护 前 发 布 系统 广播 ， 而 且 Git 是 分 散 型 版 本 管理 系 
统 ， 服 务 器 维护 并 不 会 导致 项 目 开 发 彻底 停滞 。 只 是 为 了 防止 意外 情况 
的 发 和 后， 最 好 留意 一 下 服务 顺 维 护 的 日 期 。 

GitHub 的 大 规模 系统 维护 公告 发 布 在 官方 博客 的 Broadcasts" Eo 
如 图 10.1 所 示 ， 个 人 控制 面板 的 右上 方 也 会 显示 这 个 Broadcasts。 如 果 

































































(D https;//github.com/blog/674-introducing-organizations 
Q) https;//github.com/pricing 

@)  https;//help.github.com/articles/github-security 

@  https;//github.com/blog/broadcasts 
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各 位 每 天 都 使 用 GitHub, 














那么 基本 不 用 担心 漏 看 这 一 信息 。 
10.1 “控制 面板 上 的 Broadcasts 








Stars 





(te)) Webhooks level up 


x 


Weve made major improvements in the way you 
configure, customize, and debug your webhooks. 








View 2 new broadcasts 








e 查看 故障 信息 


GitHub 在 官网 上 公开 了 故障 信息 (图 10.2 )"。 如 果 把 一 些 细微 故障 
算 进 去 ，GitHub 发 生 故 障 的 频率 还 是 相当 高 的 。 但 是 各 位 从 故障 信息 记 
录 中 不 难 发 现 ， 其 对 故障 的 反应 及 处 理 也 十 分 迅速 。 


10.2 “已 公开 的 故障 信息 日 志 


























GitHub Status 
Status Messages 


Today 


Yesterday, April 12, 2015 


April 11, 2015 


April 10, 2015 


April 09, 2015 


April 08, 2015 


April 07, 2015 





23:59UTC All systems reporting at 100% 


2359 UTC ^ All systems reporting at 100% 


23:59 UTC All systems reporting at 100% 


2359UTC All systems reporting at 100% 


23:59 UTC ^ All systems reporting at 100% 


2359UTC All systems reporting at 100% 


2359 UTC ^ All systems reporting at 100% 


UPDATED 3 MINUTES AGO 


« Dashboard 











如 果 各 位 正在 开发 的 软件 需要 在 规定 时 间 发 布 ， 建 议事 先 构建 一 个 
GitHub 之 外 的 备用 发 布 方案 ， 以 便 在 GitHub 故障 时 能 保证 按时 发 布 。 





(D — https://status.github.com/messages 
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另外 ，GitHub 还 在 官网 上 以 图 表 形 式 公 开 了 特定 时 间 段 内 各 项 服务 
的 性 能 及 正常 运行 率 等 信息 (图 10.3 )”。 各 位 在 使 用 服务 时 可 以 拿 来 做 
参考 。 


图 10.3 ”一 个 月 内 各 服务 的 运行 情况 








Past Day Past Week Past Month 


MEAN WEB RESPONSE TIME NW pv NN 
57 S 60ms 


MEAN API RESPONSE TIME 
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293ms JP JM p MA 


PAGES BUILDS FAILURE RATE 


1.355196 —— hh ARUM 


EXCEPTION PERCENTAGE 


000000 ]| , — 


MEAN HOOK DELIVERY TIME 











10.2 GitHub Enterprise 





GitHub 公司 为 需要 内 部 部 署 GitHub 的 企业 准备 了 GitHub Enterprise 
( GHE) ”。 近 年 来 ，GitHub Enterprise 已 被 许多 大 型 IT 企业 所 采用 。 





(D https:;//status.github.com/ 
Q) https:;//enterprise.github.com/ 
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e 概述 


应 用 GitHub Enterprise 等 同 于 将 GitHub 的 所 有 服务 全 部 搬 到 了 企 
业内 部 ， 同 时 也 不 再 限制 非 公开 仓库 的 创建 。 另 外 作为 面向 企业 的 功 
能 ， 账 户 管理 可 以 与 LDAP/CAS 集成 。 但 要 注意 ， 这 一 服务 需要 根据 用 
户 数 以 年 为 单位 购买 许可 证 “。 

GitHub 的 功能 升级 时 GitHub Enterprise 也 会 接 到 相应 通知 。 升 级 通 
知 会 发 送 给 管理 者 ， 管 理 者 可 以 任 选 时 间 将 GitHub Enterprise 切换 至 维 
护 模 式 ， 和 暂停 其 全 部 服务 并 进行 升级 。 

因为 升级 时 只 需 上 传 GitHub Enterprise 文件 及 License 文件 ， 所 以 
通过 浏览 器 便 可 完成 操作 。 不 过 由 于 升级 过 程 中 GitHub Enterprise 所 有 
的 服务 都 会 暂停 ， 所 以 企业 内 部 要 事先 进行 协调 。 根 据 笔者 的 经 验 ， 暂 
停 服 务 进行 升级 的 整个 过 程 大 概 需要 10 分 钟 。 

GitHub Enterprise 的 技术 支持 十 分 到 位 ， 工 作 日 从 上 午 10 时 至 下 午 
6 时 (太平 洋 标 准时 间 ) 都 有 人 负责 回答 。 根 据 官 网 的 描述 ， 通 常 问题 
会 在 1 个 工作 日 内 处 理 ，GitHub Enterprise 朋 溃 及 无 法 运行 等 紧急 | ii 
会 在 30 分 钟 内 回复 ”。 笔 者 也 曾 数 次 使 用 普通 技术 支持 ， 最 快 一 次 只 
了 4 分 钟 便 收 到 了 回复 ， 让 人 颇 有 好 感 。 









































@ 引入 的 好 处 


如 果 各 位 所 在 的 企业 是 拥有 大 量程 序 员 的 国际 型 大 企业 ,那么 引入 
GitHub Enterprise 将 会 带 来 巨大 的 收益 。 正 如 GitHub 构筑 了 一 个 公开 的 
社会 化 编程 世界 ，GitHub Enterprise 可 以 在 企业 这 个 封闭 的 世界 中 构筑 
社会 化 编程 环境 。 

如 果 企 业内 部 的 开发 者 们 构筑 起 一 个 只 属于 该 企业 的 社会 化 编程 世 
界 ， 那 么 这 可 能 会 成 为 企业 诞生 出 更 多 新 产品 的 契机 ， 或 者 创造 出 整个 
企业 通用 的 便捷 新 工具 。 



























































(D https://enterprise.github.com/pricing 
Q) https://enterprise.github.com/support 
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因此 ， 笔 者 尤其 建议 拥有 大 量程 序 员 的 企业 引入 GitHub Enterprise. 


e 5| Ad Sus 

GitHub Enterprise 同样 存在 次 端 ， 其 中 最 显著 的 就 是 运用 方面 的 成 
本 。 这 里 的 成 本 不 单 指 许可 证 费用 等 金钱 方面 的 成 本 ， 在 实际 运用 时 还 
要 为 其 准备 服务 器 ， 在 服务 器 中 安装 GitHub Enterprise， 这 些 人 力 成 本 
也 必须 考虑 进去 。 而 且 在 使 用 过 程 中 免不了 遇 到 服务 器 扩容 或 因 故 障 需 
要 更 换 等 维护 作业 ， 而 使 用 GitHub 的 话 就 不 会 有 这 些 烦 恼 。 

不 过 话说 回来 ， 肯 考虑 引入 GitHub Enterprise 的 企业 必然 具有 一 定 
的 规模 。 这 些 企 业内 部 或 多 或 少 都 有 自己 的 服务 器 或 计算 机 需要 维护 ， 仅 
仅 多 一 台 GitHub Enterprise 服务 器 对 他 们 来 说 也 不 会 有 太 多 的 成 本 提升 。 






























































@ 适合 引入 GitHub Enterprise 的 几 种 情况 


各 企业 引入 GitHub Enterprise 的 理由 各 不 相同 ， 我 们 在 这 里 介绍 其 
中 几 个 典型 的 情况 给 各 位 。 如 果 各 位 所 在 的 企业 符合 下 述 情况 之 一 ， 不 
妨 将 采用 GitHub Enterprise 一 事 提 上 讨论 日 程 。 






































e— 源 代码 不 可 外 伟 


在 某 些 企业 看 来 ， EE 于 企业 的 财产 ， 不 应 该 放 到 企业 外 部 
的 网 络 上 。 这 些 企业 适合 采用 GitHub Enterprise。 

我 们 在 使 用 GitHub 时 ， 虽 然 所 有 通信 都 经 过 HTTPS 或 SSH 等 协 
议 的 加 密 ， 但 这 仍 无 法 改变 源 代 码 在 网 络 上 传输 的 事实 。 此 外 ， 源 代码 
还 要 交 由 GitHub 方 进行 保管 。 无 论 GitHub 公司 内 部 的 管理 多 么 严格 ， 
在 很 多 企业 看 来 仍然 存在 安全 风险 。 

但 是 如 果 采 用 了 GitHub Enterprise， 在 企业 内 部 网 络 中 为 其 搭设 一 
台 服 务 器 ， 就 可 以 在 隔绝 外 部 网 络 的 防火 墙 内 侧 构筑 起 一 个 独立 的 世 
界 ， 并 且 拥 有 GitHub 的 所 有 功能 。 这 样 一 来 ， 从 网 络 面 来 看 ， 源 代码 
可 以 像 以 前 一 样 通过 代码 仓库 进行 管理 ， 避 免 了 多 余 的 安全 风险 。 
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专栏 : 将 GitHub 的 仓库 作为 Subversion 仓 库 使 用 


Subversion *? 作为 一 个 热门 版 本 管理 系统 ， 以 来 被 大 
量 系 统 所 采用 。 相 信 很 多 读者 之 前 也 在 使 用 Subversion。 
GitHub 从 名 字 上 看 总 让 人 误 以 为 其 只 支持 Git， 但 实际 上 
Subversion 也 可 以 使 用 GitHub。 



































































































































$ svn checkout https://github.com/ APZ / 仓库 名 























上 述 命 令 可 以 以 Subversion 仓库 的 形式 将 GitHub 端的 仓库 
checkout， 提 交 操作 也 可 以 用 类 似 方法 进行 ， 提 交 的 修改 内 容 会 
像 往常 一 样 反映 在 GitHub 上 。 

如 果 在 开发 过 程 中 需要 长 期 使 用 的 系统 仅 支 持 Subversion， 
那么 可 以 通过 上 述 方法 在 GitHub 上 集中 管理 Subversion 仓库 。 
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注 a http://subversion.apache.org/ 











从 这 一 观点 可 以 看 出 ， 应 用 GitHub Enterprise 的 一 般 都 是 大 型 企业 。 








e@…… 希望 维护 与 故障 时 间 可 控 


关于 GitHub 系统 维护 与 故障 的 相关 注意 事项 ， 我 们 已 经 在 本 章 的 

“注意 维护 时 间 ” 和 “查看 故障 信息 ”两 部 分 中 为 大 家 进行 了 介绍 。 由 
T GitHub 是 服务 的 提供 方 ， 所 以 维护 与 故障 都 不 受 我 们 控制 。 如 果 选 
用 了 GitHub Enterprise， 则 可 以 在 某 种 程度 上 控制 这 两 点 。 
如 果 正 在 开发 的 软件 必须 要 在 既定 时 间 发 布 ， 那么 使 用 GitHub 
Enterprise 就 能 降低 维护 与 故障 的 和 干扰。 当然， 我 们 无 法 完全 避免 
GitHub Enterprise 服务 器 自身 故障 导致 停机 等 情况 的 发 生 ， 所 以 这 类 需 
要 准时 发 布 的 软件 仍 需 事先 制定 备用 发 布 方案 ， 以 防 GitHub 或 GitHub 
Enterprise 在 关键 时 刻 出 现 问 题 。 
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10.3 ”能 实现 Git 托管 的 软件 


有 一 些 开 源 软 件 拥 有 与 GitHub 相 类 似 的 功能 。 
例如 下 面 几 种 都 比较 常用 。 


























° GitBucket” 
* GitLab? 
. Gitorious? 


e RhodeCode' 





如 果 想 免费 创建 与 GitHub 类 似 的 协作 开发 环境 ， 那 么 选择 上 述 类 
型 的 软件 不 失 为 一 个 好 办 法 。 不 过 ， 这 些 软件 虽然 提供 了 与 GitHub 类 
似 的 功能 ， 但 毕竟 不 是 GitHub 本 身 ， 所 以 在 使 用 之 前 要 先 确认 其 是 否 
包含 自己 需要 的 功能 。 

这 类 软件 都 有 自己 的 UI， 所 以 在 熟悉 操作 时 需要 花费 一 些 学 习 成 
本 。 男 外 ， 在 运用 方面 虽然 省 去 了 购买 的 开销 ,但 软件 终究 无 法 提供 
GitHub 的 所 有 便捷 服务 ， 导 致 开发 需要 时 常 注意 其 与 
GitHub 的 不 同 之 处 。 因 此 ， 如 果 要 追求 效率 ， 还 是 建议 选择 GitHub, 



















































































专栏 : Bitbucket 


Bitbucket 是 Atlassian 公司 提供 的 一 项 服务 *“*， 它 所 提供 
的 功能 与 GitHub 几乎 完全 相同 。 接 触 过 GitHub 的 用 户 在 使 用 
Bitbucket 时 不 必 学 习 新 的 概念 ， 于 UI 上 的 区 别 ， 所 以 需要 
一 个 习惯 的 过 程 。 






























































注 a https://bitbucket.org/ 





https://github.com/takezoe/gitbucket 
http://gitlabhq.com 
https://gitorious.org/gitorious 
https://rhodecode.com/ 


OOO 
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当初 该 服务 主要 为 分 散 型 版 本 管理 系统 Mercurial ^^ 提供 仓 
库 托管 服务 ， 目 前 已 经 开始 支持 Git。 
该 服务 对 每 个 账户 的 仓库 数量 及 单个 仓库 的 容量 都 没有 限 




















































































































































































































制 ， 而 且 公 开 与 私有 仓库 都 可 以 免费 创建 。 

可 随意 创建 私有 仓库 这 点 确实 很 吸引 人 ， 但 非 公 开 仓 库 的 可 
访问 用 户 数 需要 付费 购买 。 免 费 的 情况 下 只 人 允许 5 名 用 户 访 
问 权 限 ， 多 人 共用 一 个 仓库 时 势必 需要 支付 一 定 费用 。 这 方面 详 












































细 信 息 请 参考 官方 网 站 ="。 
如 果 源 代码 仅 供 个 人 或 有 限 几 人 使 用 ， 那 么 Bitbucket 要 比 
GitHub 更 能 DU 省 支 。 





















































注 b http://mercurial.selenic.com/ 
注 c https://bitbucket.org/plans 


10.4 小 结 


本 章 就 企业 导入 GitHub 时 需要 了 解 及 考虑 的 问题 进行 了 讲解 。 

GitHub 给 OSS 世界 的 软件 开发 带 来 了 变革 ， 同 样 ， 它 也 一 定 能 》 
各 位 所 在 企业 的 软件 开发 带 来 新 的 理念 。 以 软件 开发 为 主 的 企业 不 妨 积 
极 导 入 GitHub， 加 以 尝试 。 
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在 企业 中 引入 GitHub 后 ， 势 必 会 有 一 些 人 不 习惯 CLI 的 操作 。 下 





和 我 们 为 这 些 读者 介绍 几 球 简单 易 用 的 Git 的 GUI 客户 端 。 











相 较 于 不 常 接 触 的 CLI 而 言 ， GUI 客户 端 更 容易 入 门 。 但 要 想 做 到 
运用 自如 ， 必 须 先 理解 Git 的 clone、push、pull、 合 并 等 基本 概念 。 建 





议 各 位 读者 在 阅读 本 书 的 同时 ， 尽 量 实际 动手 操作 GUI 客户 端 ， 
深 记忆 。 





以 便 加 


A.1 GitHub for Mac, GitHub for Windows 














GitHub 公司 提供 了 Git 客户 端 来 辅助 用 户 使 用 GitHub。 该 客 








户 端 有 





Mac Ji C E] A.1 ) ^ ffl Windows 版 (图 A.2)2 两 个 版 本 。 两 个 客户 端 提供 











的 功能 基本 相同 ， 只 是 由 于 OS 不 同 ， 所 以 UI 有 些许 差异 。 


A.1 GitHub for Mac 





& O O Repositories > github-b: 




















| SHA: 4d763d93b7210b54f80142b94c8494762211ba28 








ia 3 Merge pull request #1 from github-book/7-case-output-github 
PT Authored by yuria on Mar 18, 2013 at 7:57 AM. 
9 Add output CitHub 


国 Showing 2 changed files with 9 additions and 1 deletion. 





Fix output GitHub 


v lib/fizzbuzz.rb 4 国 国 国 国 日 
5dldaae | 


B hirocaster 9 months ago 1 class Fizzbuzz 
Fix indent de 
fiSfe2e 2 e 














+ 
[^] er 9 months ag t 
" + elsif number X 3 == 0 && number %5 == 0 
Add output GitHub 'fizzbuzz" 
ead elsif number X 3 == 0 
'fizz" 

hirocaster 9 months ago 
Fix fizzbuzz Y spec/fizzbuzz spec.rb 6 Baage 
cagebf6 | 
B hirocaster 9monthsago || 20 | 20 it ( subject.calculate(15).should eq 'fizzbuzz' } 

it ( subject.calculate(30).should eq 'fizzbuzz' ) 
Fix fizzbuzz i 
9d + context 'GitHub number' do 

it ( subject.calculate(17).should eq 'GitHub' } 
Bb hirocaster 2 ment sqo + it { subject.calculate(27).should eq 'GitHub' ) 
Add support ruby 2.0 on travis + it { subject.calculate(75).should eq 'GitHub' } 
51412d2 + it { subject.calculate(77).should eq 'GitHub' ) 








(D https;//mac.github.com/ 
Q) https;//windows.github.com/ 
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图 A.2 GitHub for Windows 








E github-book/fizzbuzz (S) sme © sepaddttess | (8) 


no uncommitted viens Merge pull request #1 from github-book/7-case-output-github 
Mb yuria -© 4d763d9 «7 expand all [3 github 5 revert ‘f roll back 


Add output GitHub 


history 


~ libYfizzbuzz.rb 
ull request #1 from github-bo: 





hirocaster 
Add output GitHub 


B- mr 





hrocaster 
Add support ruby 2.0 on travis 
hirocaster onthsago 6 -20,4 & 
Fix travis om 











这 两 个 客户 端 都 提供 如 下 功能 。 





* 从 GitHub 端 clone 仓库 

。 显示 仓库 的 历史 记录 
。 提交 仓库 的 修改 内 容 

* 切换 分 文 

e [5] GitHub 端 进行 push 


另外 ，Mac 版 还 提供 以 下 功能 。 


。 将 通知 发 送 至 通知 中 心 
。 与 GitHub Enterprise 集成 





Mac 客户 端 支持 操作 系统 的 通知 中 心 功能 ， 即 使 不 通过 Mac 客户 端 
对 GitHub 进行 操作 ， 我 们 也 可 以 打开 该 应 用 程序 ， 来 实时 地 从 GitHub 
获取 通知 并 显示 到 通知 中 心 ， 非 常 方便 。 
这 两 个 客户 端 不 必 进 行 繁琐 的 设置 便 可 使 用 基本 功能 ， 非 常 适合 
团队 中 的 设计 师 等 并 非 是 程序 员 的 人 使 用 。 各 位 在 决定 是 否 安装 之 前 不 
妨 先 尝试 一 下 。 





























Pi 
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A.2 SourceTree 











Atlassian 公司 为 用 户 提供 了 一 款 名 为 SourceTree (图 A.3 ) ”的 应 用 
程序 。 这 一 应 用 程序 同时 支持 Git 与 Mercurial， 并 且 可 以 与 Atlassian 公 
司 提供 的 Bitbucket 以 及 内 部 部 署 中 使 用 的 Stash? 进行 集成 。 


A.3 X SourceTree 














wapress69 (ci E) 


NUNC J 




















SourceTree 除了 提供 与 GitHub 官方 客户 端 相 同 的 功能 之 外 ， 还 可 以 
为 我 们 在 9.9 节 中 讲解 的 git-flow 提供 支持 。 如 果 各 位 所 在 的 团队 采用 
了 git-flow， 那 么 相对 于 GitHub 的 官方 客户 端 ， 使 用 SourceTree 能 获得 
更 好 的 效果 。 








(D http:/www.sourcetreeapp.com/ 
Q) https://www.atlassian.com/software/stash 
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Gist” 是 一 款 简 单 的 Web 应 用 程序 ， 常 被 开发 者 们 用 来 共享 示例 代 
码 和 错误 信息 。 开 发 者 在 线 交 流 时 难免 会 涉及 软件 日 志 的 内 容 ， 但 直接 
发 送 日 志 会 占据 很 大 的 篇 幅 ， 给 交流 带 来 不 便 。 这 种 情况 下 ， 笔 者 习惯 
把 日 志 粘 贴 到 Gist， 然 后 将 URL 发 送 给 对 方 。 

此 外 ，Gist 还 可 以 用 在 如 下 场合 。 














。 代 替 记 事 本 记录 简短 代码 段 
。 给 对 方 发 送 示例 代码 








使 用 Gist 处 理 这 类 情况 可 以 省 去 不 少 麻 烦 。 


B.1 Gist 的 特点 


Gist 最 大 的 特点 是 可 以 与 其 他 人 轻松 分 享 示例 代码 。 它 使 用 
JavaScript 编写 的 Ace” 编辑 嚣 ， 只 需 打开 浏览 器 便 可 编写 简单 代码 。 

另外 ，Gist 中 的 文档 都 在 版 本 管理 系统 的 管理 之 下 ， 用 户 可 以 放心 
编辑 。 而 且 由 于 其 版 本 历史 记录 保管 在 Git 仓库 中 ， 所 以 还 可 以 通过 
clone 操作 将 Gist 获取 至 本 地 。 共 享 Gist 的 人 之 间 能 够 互相 添加 评论 ， 
所 有 交流 都 会 被 记录 下 来 。 

Gist 支持 多 种 语言 的 语法 高 亮 ， 可 以 大 幅 增强 代码 可 读 性 。 可 以 
说 ， 这 一 工具 就 是 专 为 程序 员 设 计 的 。 









































B.2 创建 Gist 








下 面 我 们 通过 实际 演示 为 各 位 讲解 Gist。 各 位 可 以 登录 GitHub 后 
点 击 上 部 菜单 中 的 Gist 或 者 直接 访问 Gist 的 URL。 随 后 我 们 可 以 看 到 














(D https://gist.github.com/ 
@ http://ace.c9.io/ 
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如 图 B.1 PATAR KI W h 











o 





图 B.1 Gist 的 首页 














GitHub Gist Discover Gists 用 hirocaster aae 
g 9602ff tlarra.cont glst:147c9463. EG 
g^ 
A language: Text ~ E nee mode Spaces ~ zl 
H 
日 日 
Add Another File 
77 
e UI 讲解 





接 下 来 我 们 就 各 个 项 目 分 别 进行 讲解 。 


e El Gist description... 








头像 右 侧 的 这 个 文本 框 用 来 对 当前 Gist 所 包含 的 文件 进行 简要 的 说 
明 。 说 明 内 容 应 尽量 简明 扼要 ， 让 自己 一 看 就 知道 是 什么 。 当 然 ， 阅 览 
者 也 能 看 到 这 里 的 信息 。 

此 项 目 并 不 是 必 填 项 ， 所 以 如 果 内 容 没 有 值得 说 明 的 地 方 ， 这 一 项 
大 可 不 必 填 写 。 




















e B name this file... 


这 一 项 可 供用 户 指 定 文件 名 。 系 统 能 够 自动 识别 扩展 名 ， 将 右 侧 的 
语言 自动 设置 为 对 应 种 类 。 比 如 我 们 输入 “hello_gist.rb”， 语 言 会 自动 
设置 为 Ruby。 

此 项 目 不 是 必 填 项 ， 缺 省 状态 下 会 以 “gistfilel. 扩展 名 ”的 形式 自 
动 分 配 名 称 。 
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H language 








这 里 可 以 给 要 创建 的 文件 选择 编程 语言 。 如 果 前 1 














名 ,那么 缺 省 名 称 的 扩展 名 将 以 这 个 设置 为 准 。 另 外 ,文件 中 的 代码 会 
按照 这 里 设置 的 语言 进行 语法 高 亮 。 


i 没有 指定 文件 
下 拉 沫 单 中 可 以 搜索 语言 
置 以 提高 可 读 性 





pi 


B.2 








I 











(图 B.2 )， 各 位 请 选择 适当 的 语言 进行 设 
果 不 更 改 设置 ， 则 文件 默认 为 文本 格式 。 
查找 编程 语言 


language: Text ~ 





Select a Language 


ruby 


Ragel in Ruby Host 


四 ACE Editor 

















该 复 选 框 可 以 指定 Ace 是 否 有 效 。 没 有 特殊 情况 还 是 建议 各 位 设置 
tab 等 操作 了 。 


为 有 效 。 这 样 一 来 ， 录 入 文件 内 容 时 就 可 以 像 善 通 编辑 器 一 样 进 行 插 入 





























右 侧 是 缩 进 的 设置 ， 可 以 选择 用 空格 缩 进 还 
选择 缩 进 幅度 的 下 拉 菜 单 。 





还 是 Tab 缩 进 。 再 右边 是 
e H 文件 
这 个 文本 框 

















j 来 编辑 文件 的 内 容 ， 可 以 手动 编写 也 可 以 从 剪贴 板 粘 
贴 。 与 我 们 常用 的 编辑 器 或 IDE 相同 ， 这 里 的 文件 内 容 会 根据 所 选 语言 
即时 语法 高 亮 。( 图 B.3 ) 

如 图 

















B.4 所 示 ，Gist 可 以 将 Markdown 语法 的 标题 以 及 编程 语 
方法 或 函数 折 羡 起 来 ， 以 大 纲 形 式 显示 内 容 。 





Ew 


言 的 
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图 B.3 ”语法 高 亮 








sample_gist.rb 


#! /usr/bin/env ruby 


1 

2 

3 puts 'Hello Gist!' 
4 

5 








图 B.4 “大纲 形式 








5 
6 og 标题 1 


8 ARI 


9 
10» # 标题 2 如 
13 








e [3 Add another File 





一 个 Gist 中 可 以 包含 多 个 文件 。 点 击 这 个 按钮 可 以 在 下 方 添加 新 的 
文件 信息 录入 框 ， 供 用 户 添加 更 多 文件 。 








e Create Secret Gist 


通过 这 个 按钮 创建 的 Gist 不 会 被 公开 ， 只 有 知道 其 URL 的 人 可 以 
阅览 相关 内 容 。 使 用 这 个 方法 能 保证 Gist 只 与 特定 几 人 共享 。 不过， 此 


E 


Gist 的 URL 一 定 要 妥善 保管 。 








e 图 Create Public Gist 


以 当前 内 容 创建 Gist。 TE Discover Gists” 上 也 可 以 看 到 创建 好 的 Gist。 
每 个 Gist 在 创建 时 都 会 被 自动 分 配 一 个 URL。 例 如 
https://gist.github.com/hirocaster/8374839 








(D https://gist.github.com/discover/ 
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我 们 可 以 通过 这 一 URL 与 其 他 开发 者 共享 该 Gist。 


B.3 查看 Gist 


这 一 节 我 们 将 从 Gist 读者 的 角度 出 发 进行 讲解 。 已 创建 的 Gist 如 图 
B.5 所 示 。 


B5 已 创建 的 Gist 





GitHub Gist Discover Gists E mrocaser m om È 
KE] hirocaster / sample gist.rb 4» - ^ Edt  @ Delete Str o 
GistD* 77), 
o | Gist Detail sample gistrb Œw o 
© Revisions 


o9 4j» Download Gist 
Qo NIV 一 











登录 Github 后 可 以 在 Gist 中 添加 评论 。 当 然 也 可 以 对 自己 的 Gist 
进行 编辑 。 





@ Gist 的 菜单 
Gist 页 菜单 的 右 侧 部 分 有 两 种 模式 ， 在 自己 的 Gist 下 (图 B.6) 与 
其 他 人 的 Gist 下 (图 B.7) 显示 的 内 容 有 所 不 同 。 











B.6 “自己 创建 的 Gist 的 菜单 





Xt -|| 9 Edt (9 Delete * Star 0 











图 B.7 ”其 他 人 创建 的 Gist 的 菜单 





Qo - *Str 0 Fork 0 
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在 自己 的 Gist 中 有 Edit (编辑 ) 和 Delete ( 删除 ) 按钮 。 
在 两 者 共有 的 Advanced Options 中 ， 可 以 通过 Report as Abuse 来 举 
报 不 良 的 Gist 内 容 。 将 Gist 标记 为 Star 后 ， 可 以 在 Your Gists 的 Starred 
页 快速 找到 这 一 Gist。Your Gists 的 相关 内 容 我 们 将 在 后 面 讲 到 。 
在 其 他 人 的 Gist 下 有 Fork 按钮 ， 用 户 可 以 根据 其 他 人 的 Gist 创建 
自己 的 Gist。 但 是 这 个 Fork 与 GitHub 不 同 ， 不 可 以 进行 Pull Request; 
下 面 我 们 就 Gist 的 每 个 页 面 进行 讲解 。 

































































e Q Gist Detail 


访问 Gist 的 URL 时 会 显示 这 个 页 面 。 在 这 里 可 以 查看 Gist 的 文件 
内 容 以 及 评论 等 详细 信息 。 








e O Revisions 

可 以 查看 Gist 的 变更 历史 记录 及 差别 。 
e © Download Gist 

将 Gist 以 tar.gz 格式 下 载 。 


e © Clone this gist 























显示 clone 所 需 的 路 径 。 如 果 是 自己 的 Gist， 在 本 地 编辑 后 还 可 以 
进行 push 等 操作 。 














e O Embed this gist 


显示 将 Gist 分 享 至 博客 时 所 需 的 HTML。 各 位 想 在 博客 上 分 享 语法 
高 亮 的 代码 时 可 以 利用 这 一 功能 。 





e Q Link to this gist 











显示 当前 Gist 的 URL. 473€ Gist 时 可 以 直接 将 这 个 URL 告诉 
对 方 。 
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e 文件 的 菜单 


各 文件 上 方 都 有 如 图 B.8 所 示 的 菜单 ， 从 左 至 右 依次 是 文件 名 ， 指 
定 的 语言 种 类 ， 永 久 链 接 ，raw 的 链接 。 如 果 想 将 Gist 中 的 一 个 文件 获 
取 到 本 地 ,使 用 永久 链接 会 比较 便捷 。 


B.8 ”文件 的 菜单 




















*| sample gist.rb 





Ruby c < 











B.4 Your Gists 


点 击 Gist 首页 右上 和 角 的 Your Gists 按钮 或 者 直接 访问 URL 都 可 以 
进入 Your Gists 页 面 "。 在 这 里 可 以 查看 自己 的 Gist 列表 。 

















B.9 X Your Gists 页 面 





GitHubGist | s^ Discover Gists [inecse m o P 


Your Gists 


| All Gists 1 Created Updated 





Fotai s Elife 8oforks 二 0commei mis rostars 
Starred 
Publie 7 a| p mpm ruby 
Secret 12 
hirocaster / gist:Sc53c3719602H386eat Eine Potoks Pocommens s ostars 
MB Last actio a montt 


d 







m def stop 
un Xill -9 “ps aux | grep [rlesque | grep -v grep | cut -c 10-167 
(current, . path) /tmp/pids/cesque *.pid" 


B mmm Ei2fies Poforks WiOcomments A Ostars 
* 


MB Last activo 3 months spo 

















(D https://gist.github.com/J] P £ / 
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cs Forked 选项 中 显示 通过 Fork 创建 的 Gist, Starred 选项 中 
显示 已 经 标记 Star 的 Gist。 文 字 右 侧 的 数字 代表 每 一 类 中 Gist 的 数量 。 














B.5 小 结 











本 部 分 中 我 们 对 Gist 进行 了 讲解 。 通 过 这 款 应 用 ， 我 们 可 以 轻松 共 
享 笔记 、 错 误 信 息 以 及 一 些 没 必 要 放 入 仓库 的 代码 片段 。 各 位 不 妨 在 日 H 
常 中 多 加 利用 ， 与 其 他 人 共享 琐碎 信息 。 
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